New-SCVMHostGroup
建立可包含虛擬機器主機電腦、其他主機群組或主機叢集的主機群組。
Syntax
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) 提供一個名為 [所有主機] 的預設父主機群組，您可以在其中新增子主機群組。 新的主機群組是空的，直到您將主機移至該群組，或在其中建立一或多個子主機群組為止。 主機群組構成階層式和可自訂的樹狀結構。 在主機群組樹狀結構中，新主機群組的父系不是預設的根主機群組 (All Hosts)，就是使用者建立的主機群組。
主機群組可以是下列任一項目的父容器：
- 主機或一組主機
- 主機群組或一組主機群組，以及這些主機群組內的主機
- 主機叢集，以及該主機叢集中) 主機 (節點
主機群組中包含的主機具有主機路徑屬性，顯示主機群組階層中該主機的位置，如下表所示：
名稱路徑
- 所有主機所有主機
- 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 預設會將此主機群組放置在根主機群組 (稱為 All Hosts) 下方。
範例 2：在指定的父主機群組下建立主機群組
PS C:\> $ParentGroup = Get-SCVMHostGroup -Name "HostGroup01"
PS C:\> New-SCVMHostGroup -Name "ChildGroup01" -ParentHostGroup $ParentGroup第一個命令會取得名為 HostGroup01 的主機群組，並將它儲存在 $ParentGroup 變數中。
第二個命令會建立名為 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
指定包含一或多個主機、主機群組或主機叢集的父主機群組。
| Type: | HostGroup |
| Aliases: | ParentVMHostGroup |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PROTipID
指定觸發此動作之 PRO 提示 (PRO 提示的識別碼) 。 此參數可讓您稽核 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
此 Cmdlet 會傳回 HostGroup 物件。