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

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

Type:	Guid
Position:	Named
Default value:	None
Required:	False
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

-ParentHostGroup

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

Type:	HostGroup
Aliases:	ParentVMHostGroup
Position:	Named
Default value:	None
Required:	True
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

-RunAsynchronously

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

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

-VMHostGroup

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

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

出力

HostGroup

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

メモ

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

関連リンク

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