The get-backup command enables you to get the backup sets for the specified criteria.
Description
get-backup-Server <server_name>-ManagementGroup <Standard|Weekly|Daily>-Database <database1, database2, ...>-StorageGroup <storage_grp1, storage_grp2, ...>-CCRActiveNode Boolean <True|False>-Backup <name_of_the_backup>-RecoveryPoint <True|False>-Details <True|False>common parameters
This cmdlet enables you to retrieve backup sets, depending on the input criteria specified in the PowerShell command-line interface.
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 name: svr
- Specifies the target Exchange server name.
- In a cluster configuration, you need to specify -Server explicitly in all of the cmdlets to perform all operations. If -Server is not specified explicitly in a stand-alone server, SnapManager uses the local machine as the default to run the following cmdlets: new-backup, verify-backup, restore-backup, get-backup, and delete-backup.
- -ManagementGroup <Standard|Weekly|Daily>
- Short name: mgmt
- Specifies the backup copy or verify operation that is scheduled to be performed on a daily, weekly, or standard basis.
- -StorageGroup <storage_grp1, storage_grp2, ...>
- Short name: sg
- Specifies the list of Storage Groups to be retrieved during the get-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 back up valid Storage Groups. Scheduled jobs and backup scripts also fail when there is an invalid Storage Group configuration.
- -Database <database1, database2, ...>
- Short name: dbs
- Lists the databases in the following format:
- -Database "DatabaseName1", "DatabaseName2"
- If you do not specify Database, the cmdlet retrieves all databases.
- -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.
- -Backup <name_of_the_backup>
- Shows the specified full backup details.
- If you do not specify Backup, get-backup displays all of the full backup copies.
- -RecoveryPoint <True|False>
- Shows the recovery point.
- -Details <True|False>
- Shows the details of the full backup copy and the recovery point.
Example: Showing the backup copies of a management group
This command shows the backup copies of the standard management group in the Storage Group alaska.
get-backup -Server SNAPMGR-48 -ManagementGroup Standard -StorageGroup alaska,3
Example: Showing all full backup copies
This command shows all of the backup copies of the Storage Group First Storage Group.
get-backup -Server SNAPMGR-48 -StorageGroup 'First Storage Group'
Example: Showing all of the full backup copies with recovery points
This command shows all of the backup copies of the Storage Group First Storage Group with recovery points.
get-backup -Server SNAPMGR-48 -StorageGroup 'First Storage Group' -RecoveryPoint
Example: Showing a specific full backup copy with recovery points
This command shows a specific backup copy of the backup set exchsnap_snapmgr-50_03-01-2007_08.00.00 in the Storage Group First Storage Group with recovery points.
get-backup -Server SNAPMGR-48 -StorageGroup 'First Storage Group' -Backup exchsnap_snapmgr-50_03-01-2007_08.00.00 -RecoveryPoint
Example: Showing a specific full backup copy with complete details
This command shows the backup set exchsnap_snapmgr-50_03-01-2007_08.00.00 with complete details.
get-backup -Server SNAPMGR-48 -StorageGroup 'First Storage Group' -Backup exchsnap_snapmgr-50_03-01-2007_08.00.00 - Details
Example: Showing both full backup copy and recovery points in detail
This command shows the backup set exchsnap_snapmgr-50_03-01-2007_08.00.00 with the recovery points in detail.
get-backup -Server SNAPMGR-48 -StorageGroup 'First Storage Group' -Backup exchsnap_snapmgr-50_03-01-2007_08.00.00 - RecoveryPoint -Details