New-SCVMHostGroup
仮想マシンのホスト コンピューター、他のホスト グループ、またはホスト クラスターを含めることができるホスト グループを作成します。
構文
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 すべてのホスト\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
ホスト グループの説明を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-EnableUnencryptedFileTransfer
True に設定すると、ネットワーク ファイル転送に暗号化は必要ないことを示します。 暗号化されていないネットワーク ファイル転送を許可すると、ソース ホストと宛先ホストのどちらも暗号化が必要でなければ、パフォーマンスが向上します。
このパラメーターを使用して、次の操作を行います。
- ライブラリとの間で暗号化されていないファイル転送を有効にします。
- ホスト グループとの間、またはホスト グループ内での暗号化されていないファイル転送を有効にします。
| 型: | Boolean |
| Aliases: | AllowUnencryptedTransfers |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-InheritNetworkSettings
$Trueに設定すると、ホスト グループのネットワーク設定の値が親グループに対して指定されているものと同じであることを示します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-JobVariable
ジョブの進行状況を追跡し、このパラメーターによって指定された変数に格納することを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Name
VMM オブジェクトの名前を指定します。
| 型: | String |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ParentHostGroup
1 つ以上のホスト、ホスト グループ、またはホスト クラスターを含む親ホスト グループを指定します。
| 型: | HostGroup |
| Aliases: | ParentVMHostGroup |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。
| 型: | Guid |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RunAsynchronously
コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-VMMServer
VMM サーバー オブジェクトを指定します。
| 型: | ServerConnection |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
出力
HostGroup
このコマンドレットは、HostGroup オブジェクトを返します。