Get-DPMCloudDatasource
Gets a list of cloud-protected data sources, protected by a DPM Server registered to the same vault as the local DPM Server.
Syntax
Default (Default)
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 - 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.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 3 |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | 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.
Parameter properties
| Type: | CloudBackupServer |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 1 |
| Mandatory: | True |
| Value from pipeline: | True |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Confirm
Prompts you for confirmation before running the cmdlet.
Parameter properties
| Type: | SwitchParameter |
| Default value: | False |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | cf |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | 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.
Parameter properties
| Type: | SecureString |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 2 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | 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.
Parameter properties
| Type: | JobStateChangedEventHandler |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | Handler |
Parameter sets
(All)
| Position: | 4 |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Parameter properties
| Type: | SwitchParameter |
| Default value: | False |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | wi |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.