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 からそのホスト コンピューターを削除するための適切なアクセス許可を持つアカウントの資格情報を指定する必要があります。

境界ネットワーク ホスト、ESX ホスト、または XenServer ホストを VMM から削除するために、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 変数に格納します。 この操作に必要な資格情報は、Active Directory ドメインに参加している Windows ベースのホスト サーバーを VMM から削除するための管理者権限を持つドメイン アカウントです。

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