SCVMM 2016 UR5 で利用可能なコマンドレット (Remove-SCVirtualizationManager) について

スポンサーリンク
Quantum_Break

System Center 2016 – Virtual Machine Manager (SCVMM 2016) に触れる機会が多くなり、Virtual Machine Manager Command Shell を使った設定や、情報取得、および管理することが増えてきたので、備忘録として各コマンドレットの概要を日本語化 (意訳) しました。

ここでは Remove-SCVirtualizationManager コマンドレットのヘルプ情報について、SCVMM2016 UR5 の Virtual Machine Manager Command Shell 上で「Remove-SCVirtualizationManager」コマンドレットの -Full オプションを用いて実行した結果を元に記載しています。
※SCVMM 2016 UR5 で利用可能なコマンドレット一覧については、「System Center 2016 – Virtual Machine Manager で利用できるコマンドレットについて」を参照。

Remove-SCVirtualizationManager コマンドレット

名前

Remove-SCVirtualizationManager

概要

VMM から VMware vCenter Server を削除します。

構文

Remove-SCVirtualizationManager
 [-VirtualizationManager] <VirtualizationManager>
 [-Confirm]
 [-JobVariable <String>]
 [-PROTipID <Guid>]
 [-RunAsynchronously]
 [-WhatIf]
 [<CommonParameters>]

説明

Remove-SCVirtualizationManager コマンドレット は、Virtual Machine Manager (VMM) から複数の VMware vCenter Server オブジェクトを削除します。 このコマンドレットは、VMM データベースから vCenter Server オブジェクトを削除し、vCenter Server に関連付けられているインポートされた ESX ホスト オブジェクトと仮想マシン オブジェクトもすべて削除します。

VirtualCenter Server を削除すると、コマンドレットは vCenter Server 内に変更を加えず、vCenter Server からホスト、もしくは仮想マシンを削除しません。

パラメーター

-Confirm [<SwitchParameter>]

コマンドレットの実行前に確認のプロンプトを表示します。

必須 false
位置 named
既定値 False
パイプライン入力を許可する False
ワイルドカード文字を許可する false

-JobVariable <String>

ジョブの進行状況を追跡し、このパラメーターで指定された変数に格納する場合に指定します。

必須 false
位置 named
既定値 None
パイプライン入力を許可する False
ワイルドカード文字を許可する false

-PROTipID <Guid>

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

必須 false
位置 named
既定値 None
パイプライン入力を許可する False
ワイルドカード文字を許可する false

-RunAsynchronously [<SwitchParameter>]

ジョブが非同期で実行、制御がすぐにコマンド シェルに戻されるかどうかを指定します。

必須 false
位置 named
既定値 False
パイプライン入力を許可する False
ワイルドカード文字を許可する false

-VirtualizationManager <VirtualizationManager>

VMM によって管理される仮想化マネージャー オブジェクトを指定します。

必須 true
位置 0
既定値 True (ByValue)
パイプライン入力を許可する False
ワイルドカード文字を許可する false

-WhatIf [<SwitchParameter>]

コマンドレットを実行する場合の挙動について表示します。コマンドレットは、実際には実行されません。

必須 false
位置 named
既定値 False
パイプライン入力を許可する False
ワイルドカード文字を許可する false

<CommonParameters>

このコマンドレットは、次の共通パラメーターをサポートします: Verbose、Debug、ErrorAction、ErrorVariable、WarningAction、WarningVariable、OutBuffer, PipelineVariable、および OutVariable。詳細については、about_CommonParameters を参照してください。

入力

出力

メモ

Get-SCVirtualizationManager コマンドレットを用いて取得可能な VMM 仮想化マネージャー オブジェクトが必要となります。

例 1 : VMM から VMware vCenter Server を削除する

コマンド
$VirtMgrServer = Get-SCVirtualizationManager -VMMServer "VMMServer01.Contoso.com" -ComputerName "VirtMgrServer01.Contoso.com"
Remove-SCVirtualizationManager -VirtualizationManager $VirtMgrServer
コマンドの説明

最初のコマンドは、”VMMServer01.Contoso.com” から仮想化マネージャー オブジェクト “VirtMgrServer01.Contoso.com” を取得し、そのオブジェクトを $VirtMgrServer 変数に格納します

2 番目のコマンドは、VMM から vCenter Server オブジェクトと関連するすべてのホストおよび仮想マシン オブジェクトを削除します。

例 2 : VMM から VMware vCenter Server セットを削除する

コマンド
$VirtManagers = Get-SCVirtualizationManager -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -match "Server" }
ForEach ($VirtManager in $VirtManagers) {Remove-SCVirtualizationManager -VirtualizationManager $VirtManager}
コマンドの説明

最初のコマンドは、名前に文字列 “Server” を含むすべての仮想化マネージャー オブジェクトを取得し、そのオブジェクトを $VirtManagers に格納します。

2 番目のコマンドは、$VirtManagers 内の各オブジェクトを VMM から削除し、関連するすべてのホスト オブジェクトと仮想マシンオブジェクトも削除します。

標準の Windows PowerShell ForEach ループ ステートメントの詳細については、Get-Help about_ForEach を実行してください。

例 3 : VMM からすべての VMware vCenter Server を削除する

コマンド
Get-SCVirtualizationManager | Remove-SCVirtualizationManager -RunAsynchronously
コマンドの説明

このコマンドは、VMM からすべての仮想化マネージャー オブジェクトを削除します。

関連するリンク

  • Add-SCVirtualizationManager
  • Get-SCVirtualizationManager
  • Read-SCVirtualizationManager
  • Set-SCVirtualizationManager

参考