New-SCVMHostGroup

モジュール:

VirtualMachineManager

仮想マシンのホスト コンピューター、他のホスト グループ、またはホスト クラスターを含めることができるホスト グループを作成します。

構文

New-SCVMHostGroup
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-ParentHostGroup <HostGroup>]
   [-EnableUnencryptedFileTransfer <Boolean>]
   [-InheritNetworkSettings <Boolean>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

説明

New-SCVMHostGroup コマンドレットは、1 つ以上の仮想マシンが展開されているホスト コンピューター、他のホスト グループ、またはホスト クラスターを含めることができるホスト グループ オブジェクトを作成します。

Virtual Machine Manager (VMM) には、すべてのホストと呼ばれる既定の親ホスト グループが用意されており、子ホスト グループを追加できます。 ホストを移動するか、その下に 1 つ以上の子ホスト グループを作成するまで、新しいホスト グループは空です。 ホスト グループは、階層状のカスタマイズ可能なツリー構造に整理されます。 ホスト グループ ツリーでは、新しいホスト グループの親は、既定のルート ホスト グループ ([すべてのホスト]) またはユーザーが作成したホスト グループのいずれかになります。

ホスト グループは、次のいずれかの親コンテナとなることができます。

• ホストまたはホストのセット
• ホスト グループまたはホスト グループのセット、およびそれらのホスト グループ内のホスト
• ホスト クラスターとそのホスト クラスター内のホスト (ノード)

ホスト グループに含まれるホストには、次の表に示すように、ホスト グループ階層内のホストの場所を示すホスト パス プロパティがあります。

名前のパス

• すべてのホスト すべてのホスト
• ChildHostGroup01 すべてのホスト\ChildHostGroup01
• ChildHostGroup02 All Hosts\ChildHostGroup02
• 新しいデータセンターのすべてのホスト\新しいデータセンター
• nested1 All Hosts\New Datacenter\nested01
• nested2 All Hosts\New Datacenter\nested\nested02

例

例 1: ルート ホスト グループの下にホスト グループを作成する

PS C:\> New-SCVMHostGroup -VMMServer "VMMServer01.Contoso.com" -Name "HostGroup01"

このコマンドは、Contoso.com ドメインの VMMServer01 に HostGroup01 という名前のホスト グループを作成します。 既定では、VMM はこのホスト グループをルート ホスト グループである [すべてのホスト] の下に配置します。

例 2: 指定した親ホスト グループの下にホスト グループを作成する

PS C:\> $ParentGroup = Get-SCVMHostGroup -Name "HostGroup01" 
PS C:\> New-SCVMHostGroup -Name "ChildGroup01" -ParentHostGroup $ParentGroup

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

2 番目のコマンドは、ChildGroup01 という名前のホスト グループを作成し、$ParentGroup変数に格納されている親ホスト グループの下に配置します。

パラメーター

-Description

ホスト グループの説明を指定します。

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

-EnableUnencryptedFileTransfer

True に設定すると、ネットワーク ファイル転送で暗号化が不要であることを示します。 暗号化されていないネットワーク ファイル転送を許可すると、ソース ホストと宛先ホストのどちらも暗号化が必要なければ、パフォーマンスが向上します。

次の場合は、このパラメーターを使用します。

• ライブラリとの間で暗号化されていないファイル転送を有効にします。
• ホスト グループとの間、またはホスト グループ内での暗号化されていないファイル転送を有効にします。

Type:	Boolean
Aliases:	AllowUnencryptedTransfers
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InheritNetworkSettings

$Trueに設定すると、ホスト グループのネットワーク設定の値が親に対して指定されたものと同じであることを示します。

Type:	Boolean
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

-Name

VMM オブジェクトの名前を指定します。

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

-ParentHostGroup

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

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

-VMMServer

VMM サーバー オブジェクトを指定します。

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

出力

HostGroup

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

関連リンク

• Get-SCVMHostGroup
• Move-SCVMHostGroup
• Remove-SCVMHostGroup
• Set-SCVMHostGroup