你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Start-AzureSiteRecoveryPlannedFailoverJob
启动 Site Recovery 计划的故障转移操作。
注意
本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧式 Azure 资源。 创建新资源时，建议不要使用旧的 PowerShell 模块，因为计划将停用 ASM。 有关详细信息，请参阅 Azure Service Manager 停用。
Az PowerShell 模块是建议用于管理 PowerShell 的 Azure 资源管理器 (ARM) 资源的 PowerShell 模块。
语法
Start-AzureSiteRecoveryPlannedFailoverJob
-RPId <String>
-Direction <String>
[-WaitForCompletion]
[-Optimize <String>]
[-Profile <AzureSMProfile>]
[<CommonParameters>] Start-AzureSiteRecoveryPlannedFailoverJob
-ProtectionEntityId <String>
-ProtectionContainerId <String>
-Direction <String>
[-WaitForCompletion]
[-Optimize <String>]
[-Profile <AzureSMProfile>]
[<CommonParameters>] Start-AzureSiteRecoveryPlannedFailoverJob
-RecoveryPlan <ASRRecoveryPlan>
-Direction <String>
[-WaitForCompletion]
[-Optimize <String>]
[-Profile <AzureSMProfile>]
[<CommonParameters>] Start-AzureSiteRecoveryPlannedFailoverJob
-ProtectionEntity <ASRProtectionEntity>
-Direction <String>
[-WaitForCompletion]
[-Optimize <String>]
[-Profile <AzureSMProfile>]
[<CommonParameters>] 说明
Start-AzureSiteRecoveryPlannedFailoverJob cmdlet 为 Azure Site Recovery 保护实体或恢复计划启动计划的故障转移。 可以使用 Get-AzureSiteRecoveryJob cmdlet 检查作业是否成功。
示例
示例 1：启动计划的故障转移作业
PS C:\> $Container = Get-AzureSiteRecoveryProtectionContainer
PS C:\> $Protected = Get-AzureSiteRecoveryProtectionEntity -ProtectionContainer $Container
PS C:\> Start-AzureSiteRecoveryPlannedFailoverJob -Direction PrimaryToRecovery -ProtectionEntity $Protected -Optimize ForDowntime
ID : c38eecdc-731c-405b-a61c-08db99aae2fe
ClientRequestId : 32ace403-0916-4967-83a1-529176bd6e88-2014-49-06 15:49:24Z-P
State : NotStarted
StateDescription : NotStarted
StartTime :
EndTime :
AllowedActions : {}
Name :
Tasks : {}
Errors : {}第一个命令使用 Get-AzureSiteRecoveryProtectionContainer cmdlet 获取当前 Azure Site Recovery 保管库中的所有受保护容器，然后将结果存储在$Container变量中。 在此示例中，有一个容器。
第二个命令使用 Get-AzureSiteRecoveryProtectionEntity cmdlet 获取属于存储在$Container中的容器的受保护虚拟机。 该命令将结果存储在$Protected变量中。
最后一个命令针对存储在 $Protected 中的受保护虚拟机，按照 PrimaryToRecovery 方向启动故障转移作业。
参数
-Direction
指定故障转移的方向。 此参数的可接受值为：
- PrimaryToRecovery
- RecoveryToPrimary
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-Optimize
指定要优化的内容。 此参数适用于从 Azure 站点故障转移到需要重大数据同步的本地站点。 此参数的可接受值为：
- ForDowntime
- ForSynchronization
指定 ForDowntime 时，这表示在故障转移之前同步数据，以最大程度地减少停机时间。 无需关闭虚拟机即可执行同步。 同步完成后，作业将暂停。 恢复作业以执行关闭虚拟机的其他同步操作。
指定 ForSynchronization 时，这表示仅在故障转移期间同步数据，以便最小化数据同步。 由于此设置已启用，虚拟机会立即关闭。 同步在关闭后开始，以完成故障转移操作。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Profile
指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件，此 cmdlet 将从本地默认配置文件中读取。
| 类型: | AzureSMProfile |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ProtectionContainerId
指定要为其启动作业的受保护容器的 ID。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-ProtectionEntity
指定 Site Recovery 保护实体对象。
| 类型: | ASRProtectionEntity |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-ProtectionEntityId
指定要 为其启动作业的 ASRProtectionEntity 对象。 若要获取 ASRProtectionEntity 对象，请使用 Get-AzureSiteRecoveryProtectionEntity cmdlet。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-RecoveryPlan
指定恢复计划对象。
| 类型: | ASRRecoveryPlan |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-RPId
指定要为其启动作业的恢复计划的 ID。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-WaitForCompletion
指示该 cmdlet 等待操作完成，然后再将控制权返回到 Windows PowerShell 控制台。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |