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 создает ресурс резервирования емкости в группе резервирования емкости

Примеры

Пример 1

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

Эта команда создаст ресурс резервирования емкости с предоставленным номером SKU и емкостью в группе резервирования емкости с именем myCapacityReservationGroup.

Пример 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

Запуск командлета в фоновом режиме

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-CapacityToReserve

Указывает количество виртуальных машин в масштабируемом наборе.

Свойства параметров

Тип:Int32
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Confirm

Запрашивает подтверждение перед запуском cmdlet.

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.

Свойства параметров

Тип:IAzureContextContainer
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Location

Указывает расположение.

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-MinimumCommitmentDayCount

Минимальное количество дней, которое должно пройти после даты начала, прежде чем можно обновить или удалить резервирование емкости в будущем после его фиксации. Должно быть не менее 30, если указано, и в противном случае значение по умолчанию — 30. Этот параметр действителен только для будущих резервирований емкости. Минимальная версия API: 2026-04-01.

Свойства параметров

Тип:Int32
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Name

Указывает имя ресурса резервирования емкости.

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:CapacityReservationName

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ReservationGroupName

Указывает имя группы резервирования емкости.

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:True
DontShow:False
Aliases:CapacityReservationGroupName

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ResourceGroupName

Указывает имя группы ресурсов.

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ScheduleProfileStart

Требуемая дата начала резервирования будущих емкостей. Это должно быть не менее 7 дней и не более 6 месяцев в будущем. В группе резервирования целевой или открытой емкости при условии, что дата начала без даты окончания создает резервирование емкости в будущем. Минимальная версия API: 2026-04-01.

Свойства параметров

Тип:DateTimeOffset
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Sku

SKU ресурса, для которого требуется резервировать емкость.

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:Size

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Tag

Указывает, что ресурсы и группы ресурсов могут быть помечены набором пар "имя-значение". Добавление тегов в ресурсы позволяет группировать ресурсы между группами ресурсов и создавать собственные представления. Каждый ресурс или группа ресурсов может содержать не более 15 тегов.

Свойства параметров

Тип:Hashtable
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-WhatIf

Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Zone

Зона доступности, используемая для резервирования емкости.

Свойства параметров

Тип:

String[]

Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Входные данные

String

Int32

DateTimeOffset

Hashtable

Выходные данные

PSCapacityReservation