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 an array of data source objects. Data source objects include the following:
-- Windows file system share or volume.
-- Microsoft SQL Server database.
-- Microsoft Exchange storage group.
-- Microsoft SharePoint farm.
-- Microsoft Virtual Machine.
-- DPM database.
-- A 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 object. 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.
Notes
- For more information, type "
Get-Help Start-DPMSwitchProtection -detailed".
Examples
Example 1: Switch protection for a data source to the secondary server
This example switches protection for a data source to a secondary DPM server. The first command gets the data protection group for a specified server by using the Get-ProtectionGroup cmdlet, and stores it in the $PG variable.
The second command uses the Get-Datasource cmdlet to obtain a data source. The command uses standard array syntax to specify the first member of the $PG array variable.
The third command switches protection to the secondary server for the data source stored in the $DS variable that is part of the protection group stored in the $PG variable. Run this example on the secondary server.
PS C:\> $PG = Get-ProtectionGroup -DPMServerName DPMServer073
PS C:\>$DS = Get-Datasource $PG[0]
PS C:\>Start-DPMSwitchProtection -ProtectionGroup $PG -Datasource $DS