Start-AzureSiteRecoveryPlannedFailoverJob

  • リファレンス
モジュール:
Azure

Site Recovery 計画フェールオーバー操作を開始します。

Note

このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用する従来の Azure リソースを管理するためのものです。 ASM の提供終了が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、Azure Service Manager の提供終了に関するページを参照してください。

Az PowerShell モジュールは、PowerShell を使用して Azure Resource Manager (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 コマンドレットは、Azure Site Recovery 保護エンティティまたは復旧計画の計画フェールオーバーを開始します。 Get-AzureSiteRecoveryJob コマンドレットを使用して、ジョブが成功したかどうかを確認できます。

例

例 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 コマンドレットを使用して、現在の Azure Site Recovery コンテナー内のすべての保護されたコンテナーを取得し、結果を $Container 変数に格納します。 この例では、1 つのコンテナーがあります。

2 番目のコマンドは、Get-AzureSiteRecoveryProtectionEntity コマンドレットを使用して、$Containerに格納されているコンテナーに属する保護された仮想マシンを取得します。 このコマンドは、結果を $Protected 変数に格納します。

最後のコマンドは、$Protectedに格納されている保護された仮想マシンの PrimaryToRecovery 方向にフェールオーバー ジョブを開始します。

パラメーター

-Direction

フェールオーバーの方向を指定します。 このパラメーターの有効値は、次のとおりです。

  • PrimaryToRecovery
  • RecoveryToPrimary
型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Optimize

最適化対象を指定します。 このパラメーターは、重要なデータ同期を必要とするオンプレミス サイトへの Azure サイトからのフェールオーバーに適用されます。 このパラメーターの有効値は、次のとおりです。

  • ForDowntime
  • ForSynchronization

ForDowntime を指定すると、ダウンタイムを最小限に抑えるために、フェールオーバー前にデータが同期されることを示します。 同期は、仮想マシンをシャットダウンせずに実行されます。 同期が完了すると、ジョブは中断されます。 ジョブを再開して、仮想マシンをシャットダウンする追加の同期操作を実行します。

ForSynchronization を指定すると、フェールオーバー中にのみデータが同期され、データ同期が最小化されることを示します。 この設定が有効になっているため、仮想マシンはすぐにシャットダウンされます。 シャットダウン後に同期が開始され、フェールオーバー操作が完了します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Profile

このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。

型:AzureSMProfile
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ProtectionContainerId

ジョブを開始する保護されたコンテナーの ID を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ProtectionEntity

Site Recovery 保護エンティティ オブジェクトを指定します。

型:ASRProtectionEntity
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ProtectionEntityId

ジョブを開始する ASRProtectionEntity オブジェクトを指定します。 ASRProtectionEntity オブジェクトを取得するには、Get-AzureSiteRecoveryProtectionEntity コマンドレットを使用します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RecoveryPlan

復旧計画オブジェクトを指定します。

型:ASRRecoveryPlan
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-RPId

ジョブを開始する復旧計画の ID を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WaitForCompletion

Windows PowerShell コンソールに制御を返す前に、コマンドレットが操作の完了を待機することを示します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False