Remove-SCVMHost
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 によって管理されなくなりましたが、他の方法では影響を受けなくなります。
- 強制削除。 Force パラメーターを Remove-SCVMHost コマンドレットと共に使用して、そのホストを管理するための適切な資格情報がない場合、または VMM サーバーがそのホストと通信できなくなった場合に、VMM から仮想マシン ホストを削除できます。
Force パラメーターを指定した場合、VMM は資格情報を要求したり確認したりしません。また、VMM がホストに接続して VMM エージェントをアンインストールしようともしません。 そのため、VMM データベースから古いホスト レコードを削除する場合にのみ、Force パラメーターを使用することをお勧めします。
このコマンドレットは、成功した場合 (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を
例 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を
例 3: VMM からアクセスできなくなった特定のホストを削除する
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost03"
PS C:\> Remove-SCVMHost -VMHost $VMHost -Force -Confirm最初のコマンドは、VMHost03 という名前のホスト オブジェクトを取得し、そのオブジェクトを $VMHost 変数に格納します。
2 番目のコマンドは、Force パラメーターで切り替えて、VMHost03 が VMM データベースから確実に削除されるようにします。 この操作には資格情報は必要ありません。 confirm パラメーターは、このホストを削除するかどうかを確認するメッセージを表示します。
注: Force パラメーターを使用すると、そのホストの資格情報がない場合、または VMM サーバーがそのホストと通信できなくなった場合に、VMM からホストを削除できます。
パラメーター
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Credential
資格情報オブジェクトを指定するか、一部のコマンドレットに対して、このアクションを実行するアクセス許可を持つアカウントのユーザー名とパスワードを含む実行アカウント オブジェクトを指定します。
または、Restart-SCJob
PSCredential オブジェクトの詳細については、「Get-Help Get-Credential」と入力します。
実行アカウントの詳細については、「Get-Help New-SCRunAsAccount」と入力します。
| 型: | VMMCredential |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Force
ユーザーの確認を求めずにコマンドを強制的に実行します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-JobVariable
ジョブの進行状況を追跡し、このパラメーターによって指定された変数に格納することを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。
| 型: | Guid |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RemoveHostWithVMs
PSCredential オブジェクトの詳細については、「Get-Help Get-Credential」と入力します。
実行アカウントの詳細については、「Get-Help New-SCRunAsAccount」と入力します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RunAsynchronously
コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-VMHost
仮想マシン ホスト オブジェクトを指定します。 VMM では、Hyper-V ホスト、VMware ESX ホスト、Citrix XenServer ホストがサポートされます。
ホストの各種類の詳細については、Add-SCVMHost コマンドレットを参照してください。
| 型: | Host |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-VMMServer
VMM サーバー オブジェクトを指定します。
| 型: | ServerConnection |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |