New-SCVMHostGroup
建立可包含虛擬機主電腦、其他主機群組或主機叢集的主機群組。
語法
New-SCVMHostGroup
[-VMMServer <ServerConnection>]
[-Name] <String>
[-Description <String>]
[-ParentHostGroup <HostGroup>]
[-EnableUnencryptedFileTransfer <Boolean>]
[-InheritNetworkSettings <Boolean>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] Description
New-SCVMHostGroup Cmdlet 會建立一個主機群組物件，其中包含一或多個虛擬機部署所在的主計算機、其他主機群組或主機叢集。
Virtual Machine Manager （VMM） 提供稱為「所有主機」的預設父主機群組，您可以新增子主機群組。 新的主機群組是空的，直到您將主機移至其中，或在其中建立一或多個子主機群組為止。 主機群組會組織成階層式且可自定義的樹狀結構。 在主機群組樹狀結構中，新主機群組的父代為預設根主機群組（所有主機）或使用者建立的主機群組。
主機群組可以是下列任一專案的父容器：
- 主機或一組主機
- 主機群組或一組主機群組，以及這些主機群組內的主機
- 主機叢集，以及該主機叢集中的主機（節點）
主機群組中包含的主機具有主機路徑屬性，顯示該主機在主機群組階層中的位置，如下表所示：
名稱路徑
- 所有主機所有主機
- 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變數中。
第二個命令會建立名為 ChildGroup01 的主機群組，並將它放在儲存在 $ParentGroup 變數的父主機群組底下。
參數
-Description
指定主機群組的描述。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-EnableUnencryptedFileTransfer
表示當設定為 True 時，網路檔案傳輸不需要加密。 如果來源主機和目的地主機都不需要加密，允許未加密的網路檔案傳輸可以改善效能。
使用此參數來：
- 啟用未加密的檔案傳輸至或移出連結庫。
- 在主機群組內啟用未加密的檔案傳輸至、移出或移出。
| 類型: | Boolean |
| 別名: | AllowUnencryptedTransfers |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-InheritNetworkSettings
指出當設定為 $True 時，主機群組的網路設定會與其父代指定的值相同。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-JobVariable
指定作業進度會追蹤並儲存在此參數所命名的變數中。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Name
指定 VMM 物件的名稱。
| 類型: | String |
| Position: | 0 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ParentHostGroup
指定包含一或多個主機、主機群組或主機叢集的父主機群組。
| 類型: | HostGroup |
| 別名: | ParentVMHostGroup |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-PROTipID
指定觸發此動作之效能和資源優化提示 （PRO 提示） 的識別碼。 此參數可讓您稽核 PRO 秘訣。
| 類型: | Guid |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-RunAsynchronously
表示作業會以異步方式執行，讓控件立即返回命令殼層。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-VMMServer
指定 VMM 伺服器物件。
| 類型: | ServerConnection |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
輸出
HostGroup
此 Cmdlet 會傳回 HostGroup 物件。