Get-DPMCloudDatasource

Reference

Module:: DataProtectionManager

Gets a list of cloud-protected data sources, protected by a DPM Server registered to the same vault as the local DPM Server.

Syntax

Get-DPMCloudDatasource
   [-CloudProtectedDPMServer] <CloudBackupServer>
   [-EncryptionPassphrase] <SecureString>
   [-Async]
   [[-JobStateChangedHandler] <JobStateChangedEventHandler>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The Get-DPMCloudDatasource cmdlet gets a list of cloud-protected data sources that are protected by a System Center 2019 - Data Protection Manager (DPM) Server registered to the same vault as the local DPM Server. This cmdlet can be used to get the data sources so that data can be recovered from the cloud recovery points of the data sources.

Examples

Example 1: Get cloud-protected data sources from a server

PS C:\> $RS = Get-DPMCloudRegisteredServers -VaultCredentialsFilePath "DPMTESTVault_Friday, September 5, 2014.VaultCredentials"
PS C:\> $Passphrase = ConvertTo-SecureString -string "passphrase123456789" -AsPlainText -Force
PS C:\> $CPD = Get-DPMCloudDatasource -CloudProtectedDPMServer $RS[0] -EncryptionPassphrase $Passphrase

The first command returns the servers registered to the vault for which vault credential file is DPMTESTVault_Friday, September 5, 2014.VaultCredentials.

The second command converts the string passphrase123456789 to a secure string and assigns the secure string to the variable named $Passphrase.

The third command returns the cloud-protected data sources from the first server in the list of servers returned by first command.

Parameters

-Async

Indicates that the command runs asynchronously. The command prompt returns immediately even if the job takes an extended time to finish.

Type:	SwitchParameter
Position:	3
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CloudProtectedDPMServer

Specifies a server from which a list of cloud-protected data sources are to be retrieved. This server must be registered to the same vault as the local DPM Server. Use the Get-DPMCloudRegisteredServers cmdlet to get a list of all the servers registered to a particular vault.

Type:	CloudBackupServer
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EncryptionPassphrase

Specifies a secure string that contains a passphrase. This passphrase should be same as the latest passphrase set on the DPM server, from which the list of data sources is retrieved to encrypt cloud backups.

Type:	SecureString
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-JobStateChangedHandler

Specifies an event handler for Job.StateChanged events. This is not needed when running in the Windows PowerShell console and is required only with a Graphical User Interface (GUI) application that is fetching data using Windows PowerShell. Use this parameter in conjunction with the Async parameter.

Type:	JobStateChangedEventHandler
Aliases:	Handler
Position:	4
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Get-DPMCloudRegisteredServers