Start-DPMSwitchProtection
Switches protection of data sources to a secondary DPM server.
Syntax
Default (Default)
Start-DPMSwitchProtection
[-ProtectionGroup] <ProtectionGroup>
[-Async]
-Datasource <Datasource[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
The Start-DPMSwitchProtection cmdlet switches protection of a set of data sources to a secondary System Center - Data Protection Manager (DPM) server. Run this cmdlet on the secondary DPM server.
Examples
Example 1: Switch protection for a data source to the secondary server
PS C:\>$PGroup = Get-DPMProtectionGroup -DPMServerName DPMServer073
PS C:\> $PObject = Get-DPMDatasource $PGroup[0]
PS C:\> Start-DPMSwitchProtection -ProtectionGroup $PGroup -Datasource $PObject
The first command gets the data protection group for a server by using the Get-DPMProtectionGroup cmdlet, and then stores it in the $PGroup variable.
The second command uses the Get-DPMDatasource cmdlet to obtain a data source. The command uses standard array syntax to specify the first member of the $PGroup array. The command stores the data source in the $PObject variable.
The third command switches protection to the secondary server for the data source in $Ds variable that is part of the protection group stored in $PGroup variable. Run this example on the secondary server.
Parameters
-Async
Indicates that the command runs asynchronously. When you run a command 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: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| 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 |
-Datasource
Specifies a data source object for which this cmdlet switches protection. A data source can be a file system share or volume for the Windows operating system, Microsoft SQL Server database, Microsoft Exchange Server storage group, Microsoft SharePoint farm, Microsoft Virtual Machine, DPM database, or system state that is a member of a protection group.
Parameter properties
| Type: | Datasource[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-ProtectionGroup
Specifies a protection group on which this cmdlet operates. To obtain a protection group object, use the Get-DPMProtectionGroup cmdlet.
Parameter properties
| Type: | ProtectionGroup |
| 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 |
-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.