New-AzCapacityReservation
Cria um recurso de Reserva de Capacidade em um Grupo de Reserva de Capacidade
Sintaxe
Default (Predefinição)
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>]
Descrição
O cmdlet New-AzCapacityReservation cria um recurso de Reserva de Capacidade em um Grupo de Reserva de Capacidade
Exemplos
Exemplo 1
New-AzCapacityReservation -ResourceGroupName "myRG" -Location "eastus" -ReservationGroupName "myCapacityReservationGroup" -Name "myCapacityReservation" -Sku "Standard_DS1_v2" -CapacityToReserve 4
Este comando criará um recurso de Reserva de Capacidade com a sku e a capacidade fornecidas no Grupo de Reserva de Capacidade denominado "myCapacityReservationGroup".
Exemplo 2
New-AzCapacityReservation -ResourceGroupName "myRG" -Location "eastus" -ReservationGroupName "myCapacityReservationGroup" -Name "myCapacityReservation" -Sku "Standard_DS1_v2" -CapacityToReserve 4 -ScheduleProfileStart "2026-12-25" -MinimumCommitmentDayCount 35
Este comando criará um recurso de Reserva de Capacidade Futura que reserva capacidade a partir de 25-12-2026, e que não poderá ser atualizado ou eliminado até que tenham passado 35 dias após a data de início após o compromisso da reserva.
Parâmetros
-AsJob
Executar cmdlet em segundo plano
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor predefinido: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-CapacityToReserve
Especifica o número de máquinas virtuais no conjunto de escala.
Propriedades dos parâmetros
Tipo: Int32
Valor predefinido: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor predefinido: None Suporta carateres universais: False NãoMostrar: False Aliases: Cf.
Conjuntos de parâmetros
(All)
Posto: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-DefaultProfile
As credenciais, conta, inquilino e subscrição usados para comunicação com o Azure.
Propriedades dos parâmetros
Tipo: IAzureContextContainer
Valor predefinido: None Suporta carateres universais: False NãoMostrar: False Aliases: AzContext, AzureRmContext, AzureCredential
Conjuntos de parâmetros
(All)
Posto: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Location
Especifica o local.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-MinimumCommitmentDayCount
O número mínimo de dias que deve passar após a data de início antes de uma Reserva de Capacidade Futura pode ser atualizado ou eliminado assim que esta tenha sido comprometida.
Deve ter pelo menos 30 se for fornecido, e caso contrário por defeito é 30.
Este parâmetro é válido apenas para Futuras Reservas de Capacidade.
Versão mínima da API: 2026-04-01.
Propriedades dos parâmetros
Tipo: Int32
Valor predefinido: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-Name
Especifica o nome do recurso de reserva de capacidade.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None Suporta carateres universais: False NãoMostrar: False Aliases: CapacityReservationName
Conjuntos de parâmetros
(All)
Posto: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-ReservationGroupName
Especifica o nome do grupo de reserva de capacidade.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None Suporta carateres universais: True NãoMostrar: False Aliases: CapacityReservationGroupName
Conjuntos de parâmetros
(All)
Posto: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-ResourceGroupName
Especifica o nome de um grupo de recursos.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-ScheduleProfileStart
A data de início exigida para uma Futura Reserva de Capacidade.
Deve ser pelo menos 7 dias e, no máximo, 6 meses no futuro.
Num grupo de reservas de capacidade Direcionada ou Aberta, fornecer uma data de início sem data de término cria uma Reserva de Capacidade Futura.
Versão mínima da API: 2026-04-01.
Propriedades dos parâmetros
Tipo: DateTimeOffset
Valor predefinido: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-Sku
SKU do recurso para o qual a capacidade precisa ser reservada.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None Suporta carateres universais: False NãoMostrar: False Aliases: Dimensão
Conjuntos de parâmetros
(All)
Posto: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-Tag
Especifica que os recursos e grupos de recursos podem ser marcados com um conjunto de pares nome-valor. Adicionar tags a recursos permite agrupar recursos entre grupos de recursos e criar suas próprias exibições. Cada recurso ou grupo de recursos pode ter no máximo 15 tags.
Propriedades dos parâmetros
Tipo: Hashtable
Valor predefinido: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado.
O cmdlet não é executado.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor predefinido: None Suporta carateres universais: False NãoMostrar: False Aliases: Wi
Conjuntos de parâmetros
(All)
Posto: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Zone
Zona de disponibilidade a utilizar para esta reserva de capacidade.
Propriedades dos parâmetros
Tipo: String [ ]
Valor predefinido: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters .
Saídas
