你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

New-AzHostGroup

创建主机组。

语法

New-AzHostGroup
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-Location] <String>
   -PlatformFaultDomain <Int32>
   [-Zone <String[]>]
   [-SupportAutomaticPlacement <Boolean>]
   [-Tag <Hashtable>]
   [-EnableUltraSSD]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

此 cmdlet 将创建主机组。

示例

示例 1

New-AzHostGroup -ResourceGroupName $resourceGroupName -Name $hostGroupName -Location $location -Zone $zone

ResourceGroupName        : myrg01
PlatformFaultDomainCount : 2
Hosts                    : {/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myrg01/providers/Microsoft.Compute/hostGroups/myhostgroup01/hosts/myhost01}
Zones                    : {1}
Id                       : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myrg01/providers/Microsoft.Compute/hostGroups/myhostgroup01
Name                     : myhostgroup01
Location                 : eastus
Tags                     : {[key1, val1]}

此命令在给定位置和区域中创建主机组。

参数

-AsJob

在后台运行 cmdlet

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:IAzureContextContainer
别名:AzContext, AzureRmContext, AzureCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-EnableUltraSSD

启用或禁用在专用主机组的专用主机上启用 UltraSSD 虚拟机的功能的标志。 若要使虚拟机启用 UltraSSD,还需要设置资源的 UltraSSDEnabled 标志。 有关超级 SSD 功能的更多详细信息,请参阅 https://learn.microsoft.com/en-us/azure/virtual-machines/disks-enable-ultra-ssd 。 只能为创建为区域性的主机组启用 ultraSSDEnabled 设置。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Location

指定位置。

类型:String
Position:2
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Name

指定主机组的名称。

类型:String
别名:HostGroupName
Position:1
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-PlatformFaultDomain

指定主机组可以跨越的容错域数。 最小值为 1,最大值为 3。

类型:Int32
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-ResourceGroupName

资源组的名称。

类型:String
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-SupportAutomaticPlacement

指定 HostGroup 是否启用 VM 的自动放置。 自动放置意味着这些 VM 放置在专用主机组下,由 Azure 选择的专用主机上。 如果未指定,则默认值为 false。

类型:Boolean
Position:Named
默认值:True
必需:False
接受管道输入:False
接受通配符:False

-Tag

指定标记

类型:Hashtable
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Zone

指定主机组的区域。

类型:String[]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

String

输出

PSHostGroup