New-SCVMHostGroup

创建可以包含虚拟机主机计算机、其他主机组或主机群集的主机组。

语法

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

说明

New-SCVMHostGroup cmdlet 创建一个主机组对象,该对象可以包含在其中部署一个或多个虚拟机、其他主机组或主机群集的主机。

Virtual Machine Manager (VMM) 提供了一个名为“所有主机”的默认父主机组,你可以向其添加子主机组。 新主机组为空,直到将主机移动到其中或创建一个或多个子主机组。 按照层次结构和自定义的树结构组织主机组。 在主机组树中,新的主机组的父级是默认的根主机组(所有主机)或用户创建的主机组。

主机组可以是以下任何项的父级容器:

  • 主机或主机集
  • 主机组或主机组,以及这些主机组中的主机
  • 主机群集和主机 (节点) 在该主机群集中

主机组中包含的主机具有主机路径属性,该属性显示主机组层次结构中该主机的位置,如下表所示:

名称路径

  • 所有主机
  • 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变量中。

第二个命令创建名为 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 提示) 的性能和资源优化提示的 ID。 此参数允许审核 PRO 提示。

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

-RunAsynchronously

指示作业以异步方式运行,以便控件立即返回到命令 shell。

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 对象。