Get-WBBackupSet
Gets backups for a server from a location that you specify.
Syntax
Get-WBBackupSet
[[-BackupTarget] <WBBackupTarget>]
[[-MachineName] <String>]
[<CommonParameters>] Description
The Get-WBBackupSet cmdlet gets a list of WBBackupSet objects that contain backups for a server from a location that you specify. A WBBackupSet object contains information about the backup time and date, the backed-up computer, the backup type, and the items that were part of the backup.
To use this cmdlet, you must be a member of the Administrators group or Backup Operators group.
Examples
Example 1: Get server backups from the system catalog
PS C:\> $Backups = Get-WBBackupSetThis command gets server backups from the system catalog and stores them in the $Backups variable.
Example 2: Get server backups from a specific location
PS C:\> $BackupLocation = New-WBBackupTarget -VolumePath D:
PS C:\> $Backups = Get-WBBackupSet -BackupTarget $BackupLocationThis example queries the catalog at a specific storage location for backups.
The first command creates a backup target on the volume that has the drive letter D: and stores this location in the variable named $BackupLocation.
The second command gets backup data from the backup target in $BackupLocation and then stores this data in the variable named $Backups.
Parameters
-BackupTarget
Specifies a WBBackupTarget object. This object includes the storage location that contains the backups for which you want details.
Use this parameter to get information about backups of computers other than the local computer. The cmdlet lists the backup sets from the catalog on the computer that you specify, not from the system catalog of the local computer. Alternate locations can be locally attached disk drives or remote shared folders.
When you specify this parameter along with the MachineName parameter, the cmdlet returns backup information from the storage location that you specify in this parameter. This storage location is on the server that you specify in the MachineName parameter.
| Type: | WBBackupTarget |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MachineName
Specifies the computer for which you want backup details.
Use this parameter when backups of different computers appear in the same location or when you use the BackupTarget parameter to specify a storage location that contains the backup details.
When you specify this parameter along with the BackupTarget parameter, the cmdlet returns backup information from the storage location that you specify in the BackupTarget parameter. The storage location is on the server that you specify in this parameter.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Inputs
None