delete-backup

The delete-backup command enables you to delete backup sets.

Description

        delete-backup-Server <server_name>-backup <backup_name>-NoUTMRestore <True|False>-StorageGroup <storage_grp_name>-Database <name of the database>-CCRActiveNode <True|False>-RemoteBackup <True|False>-ArchiveBackup <True|False>common parameters

Use this command to delete backup sets.

This command also supports the following common parameters:

-Debug (-db)
-ErrorAction (-ea)
-ErrorVariable (-ev)
-OutBuffer (-ob)
-OutVariable (-ov)
-Verbose (-vb)
-Confirm

To learn more about common parameters, see help about_ubiquitous_parameters.

-Server <server_name>: Short form: svr; Use this parameter to specify the name of the backup server.
Note: In a clustered configuration, specify Server explicitly in all of the cmdlets to perform an operation. If you do not specify Server explicitly in a stand-alone server, SnapManager uses the local machine, as default, to run the following cmdlets: new-backup, verify-backup, restore-backup, get-backup, and delete-backup.

Note: For Exchange Server 2010, you cannot specify the Database Availability Group (DAG) name in this parameter as it is not supported.
-backup <backup_name>: Specifies the name of the backup set.
-NoUTMRestore <True|False>: Short name: noutm; Denies the retention of up-to-the-minute restore ability.; The logs are also deleted for any backups that you delete as part of this backup operation. This does not retain the up-to-the-minute restore ability for older backups that remain after the delete phase of a backup operation.
-StorageGroup <storage_grp1, storage_grp2, ...>: Short name: sg; Specifies the list of Storage Groups to be verified during the backup operation.; If invalid Storage Groups are specified in new-backup during backup operation, PowerShell cancels the new-backup operation. SnapManager displays an appropriate error message and does not selectively backup any valid Storage Groups. Scheduled jobs and backup scripts also fail when there is an invalid Storage Group configuration.
-Database <name of the database>: Short name: dbs; Specifies the name of the database to be deleted.; This is a mandatory parameter if the cmdlet is deleting a database of Exchange Server 2010.
-CCRActiveNode Boolean <True|False>: Short name: ccrnode; Specifies whether the connection is to an active or a passive node, respectively. This is a Boolean parameter.
-RemoteBackup <True|False>: Deletes the archived backup copies.; If RemoteBackup is not specified, the local backup copies get deleted.

Example: Deleting a specific backup set of a specified Storage Group

This command deletes the backup set exchsnap__SNAPMGR-55_11-10- 2006_13.39.16.

delete-backup -backup exchsnap__SNAPMGR-55_11-10- 2006_13.39.16

Example: Deleting the Snapshot copy of a specified LCR backup set

This command deletes the Snapshot copy of the backup set exchsnap__KRISHNA-SVR18 _11-10-2006_13.39.16 that belongs to the LCR-enabled Storage Group sg4 (LCR).

delete-backup -storagegroup sg4 (LCR) -backup exchsnap__KRISHNA-SVR18 _11-10-2006_13.39.16 -verbose -confirm

Example: Deleting a specific backup set that belongs to the Storage Group 'sg1' without up-to-the-minute restore ability

This command deletes the backup set exchsnap__KRISHNA-SVR18__11-01-2006_18.12.22 without up-to-the-minute restore ability.

delete-backup -storagegroup sg2 -backup exchsnap__KRISHNA-SVR18__11-01-2006_18.12.22 -NoutmRestore -verbose -confirm