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

New-AzCapacityReservation

在容量预留组中创建容量预留资源

语法

Default (默认值)

New-AzCapacityReservation
    -ResourceGroupName <String>
    -ReservationGroupName <String>
    -Name <String>
    -Location <String>
    -CapacityToReserve <Int32>
    -Sku <String>
    [-AsJob]
    [-Tag <Hashtable>]
    [-Zone <String[]>]
    [-ScheduleProfileStart <DateTimeOffset>]
    [-MinimumCommitmentDayCount <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

New-AzCapacityReservation cmdlet 在容量预留组中创建容量预留资源

示例

示例 1

New-AzCapacityReservation -ResourceGroupName "myRG" -Location "eastus" -ReservationGroupName "myCapacityReservationGroup" -Name "myCapacityReservation" -Sku "Standard_DS1_v2" -CapacityToReserve 4

此命令将在名为“myCapacityReservationGroup”的容量预留组中创建具有提供的 SKU 和容量的容量预留资源。

示例 2

New-AzCapacityReservation -ResourceGroupName "myRG" -Location "eastus" -ReservationGroupName "myCapacityReservationGroup" -Name "myCapacityReservation" -Sku "Standard_DS1_v2" -CapacityToReserve 4 -ScheduleProfileStart "2026-12-25" -MinimumCommitmentDayCount 35

此命令将创建一个未来容量预留资源,该资源从 2026-12-25 开始保留容量,在提交预留后 35 天后才能更新或删除该资源。

参数

-AsJob

在后台运行 cmdlet

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-CapacityToReserve

指定规模集中的虚拟机数。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Confirm

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DefaultProfile

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

参数属性

类型:IAzureContextContainer
默认值:None
支持通配符:False
不显示:False
别名:AzContext, AzureRmContext, AzureCredential

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Location

指定位置。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-MinimumCommitmentDayCount

在提交容量预留后,在开始日期之后必须经过的最小天数,才能更新或删除未来容量预留。 如果提供,则必须至少为 30,否则默认为 30。 此参数仅适用于将来的容量预留。 最低API版本:2026-04-01。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Name

指定容量预留资源的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False
别名:CapacityReservationName

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-ReservationGroupName

指定容量预留组的名称。

参数属性

类型:String
默认值:None
支持通配符:True
不显示:False
别名:CapacityReservationGroupName

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-ResourceGroupName

指定资源组的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-ScheduleProfileStart

未来容量预留所需的开始日期。 它必须至少为 7 天和将来最多 6 个月。 在“目标”或“开放容量预留”组中,提供无结束日期的开始日期将创建将来的容量预留。 最低API版本:2026-04-01。

参数属性

类型:DateTimeOffset
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Sku

需要为其保留容量的资源的 SKU。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False
别名:尺寸

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Tag

指定可以使用一组名称值对标记资源和资源组。 将标记添加到资源后,可以跨资源组将资源组合在一起,并创建自己的视图。 每个资源或资源组最多可以有 15 个标记。

参数属性

类型:Hashtable
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:WI

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Zone

要用于此容量预留的可用性区域。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持以下常用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。

输入

String

Int32

DateTimeOffset

Hashtable

输出

PSCapacityReservation