
PowerProtect Data Manager 19.15 Microsoft Exchange Server User Guide
List backups with the Get-ExchangeBackup cmdlet
To list Microsoft Exchange Server backups, use the Get-ExchangeBackup cmdlet.
Use the Get-ExchangeBackup PowerShell cmdlet with the following syntax to list Microsoft Exchange Server backups on a DD server:
[<configuration_object>] | Get-ExchangeBackup -BackupViaBlockBasedBackup -DataDomainHost <DD_hostname> -DataDomainUser <DD_username> -DataDomainHostPath /<DD_storage_path> -ClientName <FQDN_of_Microsoft_Exchange_Server> [<optional_parameters>]
where:
- <configuration_object>
-
(Optional) Specifies the configuration object that was imported using the Import-ExchangeBackupConfigFile cmdlet.
NOTE:For PowerProtect Data Manager centralized and self-service workflows, run the Import-ExchangeBackupConfigFile cmdlet with the -Restore parameter to import the configuration parameters to the object. - -BackupViaBlockBasedBackup
- Specifies to list the block-based backups.
- You can use the -BBB or -BlockBasedBackup alias for the -BackupViaBlockBasedBackup parameter.
- -ClientName <Microsoft_Exchange_Server_FQDN>
- Specifies the FQDN of the stand-alone Microsoft Exchange Server or database availability group instance to use for listing the backup.
- You can use the -C or -CN alias for the -ClientName parameter.
- -DataDomainHost <DD_hostname>
- Specifies the DD server hostname.
- You can use the -S, -SH, -DDHost or -StorageHost alias for the -DataDomainHost parameter.
- -DataDomainHostPath /<DD_storage_path>
- Specifies the full path to the DD storage unit to query for the backups. The DD user must have appropriate access rights to this path.
- You can use the -Path, -DevicePath, -StoragePath, -StorageHostPath, or -DataDomainPath alias for the -DataDomainHostPath parameter.
- -DataDomainUser <DD_username>
- Specifies the DD username.
- Full credentials are retrieved from the lockbox to authenticate with the host. -DDUser, -StorageUser
- You can use the -DDUser or -StorageUser alias for the -DataDomainUser parameter.
Depending on the number of backups and network performance, the Get-ExchangeBackup cmdlet may require significant time to list the backups.
For the listing of backups, use the Import-ExchangeBackupConfigFile cmdlet only with the -Restore parameter. Listing of backups with Import-ExchangeBackupConfigFIle -Backup produces invalid results.
Due to excessive property length, property values might not be completely visible and shown in the dots after a fixed length. In this case, use the FormatEnumerationLimit and Format-List parameters to increase the property length and to see the full property values.
Formatting the list of backups describes multiple formatting options and filters.
The -ExcludeClientNameResolution parameter, as described in the next topic, is mandatory for IP-less DAG restores with PowerProtect Data Manager integrated workflows (both self-service and centralized).