Complete-VMFailover

[アーティクル]
11/16/2015

Complete-VMFailover

Completes a virtual machine’s failover process on the Replica server. Removes all recovery points on a failed over virtual machine.

構文

Parameter Set: VMName
Complete-VMFailover [-VMName] <String[]> [-CimSession <Microsoft.Management.Infrastructure.CimSession[]> ] [-ComputerName <String[]> ] [-Credential <System.Management.Automation.PSCredential[]> ] [-Passthru] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: VMObject
Complete-VMFailover [-VM] <VirtualMachine[]> [-Passthru] [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細説明

The Complete-VMFailover cmdlet completes a virtual machine’s failover process on the Replica server. The recovery point, on which the virtual machine is failed over, is committed and all other recovery points are removed. Failover cannot be canceled after the recovery points are removed.

パラメーター

-CimSession<Microsoft.Management.Infrastructure.CimSession[]>

リモートセッションまたはリモートコンピューターでコマンドレットを実行します。コンピューター名またはセッションオブジェクト (New-CimSession コマンドレットや Get-CimSession コマンドレットの出力など) を入力します。既定値は、ローカルコンピューター上の現在のセッションです。

Aliases	none
必須/オプション	false
位置	named
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-ComputerName<String[]>

Specifies one or more Hyper-V hosts on which the failover process is to be completed. NetBIOS names, IP addresses, and fully qualified domain names are allowable. The default is the local computer. Use localhost or a dot (.) to specify the local computer explicitly.

Aliases	none
必須/オプション	false
位置	named
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-Credential<System.Management.Automation.PSCredential[]>

Specifies one or more user accounts that have permission to perform this action. The default is the current user.

Aliases	none
必須/オプション	false
位置	named
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-Passthru

Indicates that this cmdlet returns the Microsoft.HyperV.PowerShell.VirtualMachine on which it operates. By default, this cmdlet does not return a value.

Aliases	none
必須/オプション	false
位置	named
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-VM<VirtualMachine[]>

Specifies the virtual machine whose failover process is to be completed.

Aliases	none
必須/オプション	true
位置	1
既定値	none
パイプライン入力の受け入れ	true (ByValue)
ワイルドカード文字の受け入れ	false

-VMName<String[]>

Specifies the name of the virtual machine whose failover process is to be completed.

Aliases	none
必須/オプション	true
位置	1
既定値	none
パイプライン入力の受け入れ	true (ByValue)
ワイルドカード文字の受け入れ	false

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

必須/オプション	false
位置	named
既定値	false
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-WhatIf

コマンドレットが実行された場合に何が起きるのかを示します。コマンドレットは実行されません。

必須/オプション	false
位置	named
既定値	false
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

<CommonParameters>

このコマンドレットは共通のパラメーターをサポートしています(-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、および -OutVariable)。詳細については、TechNet の「「about_CommonParameters」 (https://go.microsoft.com/fwlink/p/?LinkID=113216) を参照してください。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットが出力するオブジェクトの型です。

None by default; Microsoft.HyperV.PowerShell.VirtualMachine if –PassThru is specified.

使用例

Example 1

This command completes the failover process of a virtual machine named VM01, thereby deleting all other recovery points on the server.

PS C:\> Complete-VMFailover VM01

Example 2

This command completes the failover process of all virtual machines on the local host for which the failover process has been started.

PS C:\> Complete-VMFailover *

Complete-VMFailover