Move-SCVMHostGroup

モジュール:

VirtualMachineManager

ホスト グループを現在の場所から別のホスト グループの親の下の新しい場所に移動します。

構文

Move-SCVMHostGroup
    [-VMHostGroup] <HostGroup>
    [-JobGroup <Guid>]
    -ParentHostGroup <HostGroup>
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

説明

Move-SCVMHostGroup コマンドレットは、仮想マシン マネージャー (VMM) によって管理される仮想マシン ホストを含む 1 つ以上のホスト グループ オブジェクトを、現在の場所から別のホスト グループの親の下の新しい場所に移動します。 ホスト グループは、既定のルート ホスト グループ (すべてのホスト) の下、または管理者によって作成された他のホスト グループの下に配置できます。

移動されたホスト グループ内のすべてのホストは、ルート ホスト グループを基準とした新しいホスト パスを取得します。 ホスト グループの構造を変更すると、影響を受けるホスト グループ内に含まれるホスト、またはそれらのホストにデプロイされている仮想マシンにアクセスできるセルフサービス ユーザーまたは代理管理者ユーザー ロールが変更される可能性があります。

例

例 1: 1 つのホスト グループを新しい親ホスト グループに移動する

PS C:\> $OldHostGroup = Get-SCVMHostGroup -Name "OldHostGroup"
PS C:\> $NewHostGroup = Get-SCVMHostGroup -Name "NewHostGroup"
PS C:\> Move-SCVMHostGroup -VMHostGroup $OldHostGroup -ParentHostGroup $NewHostGroup

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

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

最後のコマンドは、$OldHostGroup変数 (OldHostGroup) に格納されているホスト グループを、$NewHostGroup変数に格納されている新しい親ホスト グループの下の場所に移動します。

例 2: すべてのホスト グループを新しい親ホスト グループに移動する

PS C:\> $AllGroups = Get-SCVMHostGroup
PS C:\> $HostGroup = New-SCVMHostGroup -Name "NewHostGroup01" 
PS C:\> $AllGroups | Move-SCVMHostGroup -ParentHostGroup $HostGroup

最初のコマンドは、すべてのホスト グループ オブジェクトを取得し、$AllGroups配列に格納します。 これには、既定の親ホスト グループ (すべてのホスト) が含まれます。

2 番目のコマンドは、NewHostGroup01 という名前のホスト グループ オブジェクトを作成し、$HostGroup変数に格納します。

最後のコマンドは、$AllGroups変数に格納されている各ホスト グループ オブジェクトを Move-VMHostGroup コマンドレットに渡します。このコマンドレットは、すべてのホストが既定の親ホスト グループであり、移動できないため、すべてのホストを除き、各ホスト グループ オブジェクトを $HostGroup 変数に格納されている場所に移動します。

パラメーター

-JobGroup

同じジョブ グループ識別子を含む最後のコマンドが実行される直前にセットとして実行される一連のコマンドの識別子を指定します。

型:	Guid
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-JobVariable

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ParentHostGroup

1 つ以上のホスト、ホスト グループ、またはホスト クラスターを含む親ホスト グループを指定します。

型:	HostGroup
Aliases:	ParentVMHostGroup
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PROTipID

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

型:	Guid
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RunAsynchronously

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

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-VMHostGroup

仮想マシン ホスト グループ オブジェクトを指定します。

型:	HostGroup
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

出力

HostGroup

このコマンドレットは、HostGroup オブジェクトを返します。

メモ

• Get-SCVMHostGroup コマンドレットを使用して取得できる VMM ホスト グループ オブジェクトが必要です。

関連リンク

• Get-SCVMHostGroup
• New-SCVMHostGroup
• Remove-SCVMHostGroup
• Set-SCVMHostGroup