Table of ContentsLibraryView in Frames

get-backup

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