Start-DPMSwitchProtection
Start-DPMSwitchProtection
Switches protection of data sources to a secondary DPM server.
Syntax
Parameter Set: Default
Start-DPMSwitchProtection [-ProtectionGroup] <ProtectionGroup> -Datasource <Datasource[]> [-Async] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The Start-DPMSwitchProtection cmdlet switches protection of a set of data sources to a secondary System Center 2012 – Data Protection Manager (DPM) server. Run this cmdlet on the secondary DPM 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.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Datasource<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.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-ProtectionGroup<ProtectionGroup>
Specifies a protection group on which this cmdlet operates. To obtain a protection group object, use the Get-DPMProtectionGroup cmdlet.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
-Confirm
Prompts you for confirmation before running the cmdlet.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
Examples
Example 1: Switch protection for a data source to the secondary server
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.
PS C:\> $PGroup = Get-DPMProtectionGroup -DPMServerName DPMServer073
PS C:\> $PObject = Get-DPMDatasource $PGroup[0]
PS C:\> Start-DPMSwitchProtection -ProtectionGroup $PGroup -Datasource $PObject