Remove-SCVMHost

モジュール:

VirtualMachineManager

VMM から仮想マシン ホストを削除します。

構文

Remove-SCVMHost
      [-VMHost] <Host>
      [-VMMServer <ServerConnection>]
      [-Credential <VMMCredential>]
      [-RemoveHostWithVMs]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-SCVMHost
      [-VMHost] <Host>
      [-VMMServer <ServerConnection>]
      [-Force]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

Remove-SCVMHost コマンドレットは、仮想マシン マネージャー (VMM) から 1 つ以上の仮想マシン ホストを削除します。 Remove-SCVMHost コマンドレットは次のように動作します。

• ホスト サーバーのみ。 このコンピューターが Hyper-V ホストで、ライブラリ サーバーではない場合、ホスト オブジェクトは VMM データベースから削除され、VMM エージェント ソフトウェアは物理ホスト サーバーからアンインストールされます。

ホストが VMware ESX ホストまたは Citrix XenServer ホストの場合、ホスト オブジェクトは VMM データベースから削除されます。 VMM は、ESX ホストまたは XenServer ホストにエージェントをインストールしません。

• ホスト サーバーとライブラリ サーバー。 このコンピューターが Hyper-V ホストであり、ライブラリ サーバーでもある場合、このコマンドはホスト機能のみを削除しますが、ライブラリ サーバー機能はそのまま残します。 つまり、ホスト オブジェクトは VMM データベースから削除されますが、VMM エージェント ソフトウェアは物理サーバーからアンインストールされません。 ライブラリ サーバー オブジェクトはデータベースに残ったままになります。

ホストが ESX ホストの場合、VMM の仮想マシン ホストとしてのみ機能できます。 ホストとライブラリ サーバーの両方としては機能できません。

• 資格情報: Hyper-V ホストが Active Directory ドメインに参加している場合は、VMM からそのホスト コンピューターを削除するための適切なアクセス許可を持つアカウントの資格情報を指定する必要があります。

VMM から境界ネットワーク ホスト、ESX ホスト、または XenServer ホストを削除するために、Active Directory 資格情報を指定する必要はありません。

• [仮想マシン]: ホストを削除すると、ホストは VMM によって管理されなくなります。 ただし、ホスト サーバー上の仮想マシンは、サーバーから削除または関連付け解除されることはありません。 実行中の仮想マシンはシャットダウンされません。 仮想マシンは VMM によって管理されなくなりましたが、他の方法では影響を受けません。
• 強制削除。 Remove-SCVMHost コマンドレットで Force パラメーターを使用すると、そのホストを管理するための適切な資格情報がない場合、または VMM サーバーがそのホストと通信できなくなった場合に、VMM から仮想マシン ホストを削除できます。

Force パラメーターを指定しても、VMM は資格情報の確認や要求を行わず、VMM はホストに接続して VMM エージェントをアンインストールしようともしません。 そのため、 Force パラメーターを使用することは、VMM データベースから古いホスト レコードを削除する場合にのみお勧めします。

このコマンドレットは、成功した場合 (MarkedForDeletion プロパティが$Trueに設定されている) オブジェクトを返すか、失敗した場合にエラー メッセージを返します。

例

例 1: VMM から特定のドメイン参加ホストを削除する

PS C:\> $Credential = Get-Credential
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01"
PS C:\> Remove-SCVMHost -VMHost $VMHost -Credential $Credential -Confirm

最初のコマンドでは 、Get-Credential コマンドレットを使用して、ユーザー名とパスワードの入力を求め、指定された資格情報を $Credential 変数に格納します。 この操作に必要な資格情報は、Vmm から Active Directory ドメインに参加している Windows ベースのホスト サーバーを削除する管理者権限を持つドメイン アカウントです。

2 番目のコマンドは、VMHost01 という名前のホスト オブジェクトを取得し、そのオブジェクトを $VMHost 変数に格納します。

3 番目のコマンドは、$VMHostに格納されているホスト オブジェクトを削除します。 このコマンドが処理されると、$Credentialは Remove-VMHost に資格情報を提供し、 Confirm パラメーターは VMM からこのホストを削除することを確認するように求められます。

例 2: VMM からホスト クラスター内のノードではないすべてのホストを削除する

PS C:\> Get-SCVMHost | where {$_.HostCluster -eq $NULL} | where {$_.VirtualizationPlatform -eq "VMwareESX" -or $_.PerimeterNetworkHost -eq 1 -or $_.NonTrustedDomainHost -eq 1} | Remove-SCVMHost -Confirm
PS C:\> $Credential = Get-Credential
PS C:\> Get-VMHost | where {$_.HostCluster -eq $NULL -and $_.VirtualizationPlatform -ne "VMwareESX" -and $_.PerimeterNetworkHost -eq 0 -and $_.NonTrustedDomainHost -eq 0} | Remove-VMHost -Credential $Credential -Confirm

最初のコマンドは、すべてのホスト オブジェクトを取得し、ホスト クラスター内のノードであるホストを除外し、VMware ESX ホスト、境界ネットワーク ホスト、または信頼されていないドメイン ホストを表すオブジェクトのみを選択し、削除することを確認した場合は VMM からそれらのオブジェクトを削除します。 これらのホストを削除するのに、資格情報は必要ありません。

2 番目のコマンドでは、VMM からドメインに参加している Windows ホストを削除するアクセス許可を持つアカウントのユーザー名とパスワードを指定するように求め、資格情報を$Credentialに格納します。

最後のコマンドは、ホスト クラスターに含まれていないすべてのドメイン参加済み Windows ベースのホスト オブジェクトを取得し、 オブジェクトを Remove-VMHost コマンドレットに渡します。 このコマンドが処理されると、$Credential は Remove-VMHost に資格情報を提供し、 Confirm パラメーターは VMM からこれらのホストを削除することを確認するように求められます。

例 3: VMM からアクセスできなくなった特定のホストを削除する

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost03"
PS C:\> Remove-SCVMHost -VMHost $VMHost -Force -Confirm

最初のコマンドは、VMHost03 という名前のホスト オブジェクトを取得し、$VMHost変数にオブジェクトを格納します。

2 番目のコマンドは、VMHost03 が VMM データベースから確実に削除されるように 、Force パラメーターを切り替えます。 この操作には資格情報は必要ありません。 Confirm パラメーターは、このホストを削除することを確認するメッセージを表示します。

注: Force パラメーターを使用すると、そのホストの資格情報がない場合、または VMM サーバーがそのホストと通信できなくなった場合に、VMM からホストを削除できます。

パラメーター

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

資格情報オブジェクトを指定するか、一部のコマンドレットに対して、このアクションを実行するアクセス許可を持つアカウントのユーザー名とパスワードを含む実行アカウント オブジェクトを指定します。 または、 Restart-SCJob の場合は、再起動されたタスクを完了するためのアクセス許可を持ちます。

PSCredential オブジェクトの詳細については、「Get-Help Get-Credential.

実行アカウントの詳細については、「.」と入力します Get-Help New-SCRunAsAccount。

Type:	VMMCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

ユーザーに確認せずに、直ちにコマンドを実行します。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-JobVariable

ジョブの進行状況を追跡して、このパラメーターで示す名前の変数に保管するように指定します。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PROTipID

このアクションをトリガーしたパフォーマンスとリソース最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。

Type:	Guid
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveHostWithVMs

PSCredential オブジェクトの詳細については、「Get-Help Get-Credential.

実行アカウントの詳細については、「.」と入力します Get-Help New-SCRunAsAccount。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RunAsynchronously

コントロールがコマンド シェルに直ちに戻るように、ジョブが非同期的に実行されることを示します。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VMHost

仮想マシン ホスト オブジェクトを指定します。 VMM では、Hyper-V ホスト、VMware ESX ホスト、Citrix XenServer ホストがサポートされています。

ホストの種類の詳細については、 Add-SCVMHost コマンドレットを参照してください。

Type:	Host
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-VMMServer

VMM サーバー オブジェクトを指定します。

Type:	ServerConnection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

関連リンク

• Add-SCVMHost
• Disable-SCVMHost
• Enable-SCVMHost
• Get-SCVMHost
• Move-SCVMHost
• New-SCVMHost
• Read-SCVMHost
• Register-SCVMHost
• Repair-SCVMHost
• Restart-SCVMHost
• Set-SCVMHost
• Start-SCVMHost
• Stop-SCVMHost