New-AzCapacityReservation
Crea un recurso de reserva de capacidad en un grupo de reserva de capacidad
Sintaxis
Default (valor predeterminado)
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>]
Description
El cmdlet New-AzCapacityReservation crea un recurso de reserva de capacidad en un grupo de reservas de capacidad.
Ejemplos
Ejemplo 1
New-AzCapacityReservation -ResourceGroupName "myRG" -Location "eastus" -ReservationGroupName "myCapacityReservationGroup" -Name "myCapacityReservation" -Sku "Standard_DS1_v2" -CapacityToReserve 4
Este comando creará un recurso de reserva de capacidad con la SKU y la capacidad proporcionadas en el grupo de reserva de capacidad denominado "myCapacityReservationGroup".
Ejemplo 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 creará un recurso reserva de capacidad futura que reserva la capacidad a partir del 2026-12-25 y que no se puede actualizar o eliminar hasta que se hayan pasado 35 días después de la fecha de inicio una vez confirmada la reserva.
Parámetros
-AsJob
Ejecución del cmdlet en segundo plano
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Mandatory: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-CapacityToReserve
Especifica el número de máquinas virtuales del conjunto de escalado.
Propiedades de parámetro
Tipo: Int32
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Mandatory: True Valor de la canalización: False Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: False
-Confirm
Le pide confirmación antes de ejecutar el cmdlet.
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None Admite caracteres comodín: False DontShow: False Alias: cf
Conjuntos de parámetros
(All)
Posición: Named Mandatory: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-DefaultProfile
Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.
Propiedades de parámetro
Tipo: IAzureContextContainer
Valor predeterminado: None Admite caracteres comodín: False DontShow: False Alias: AzContext, AzureRmContext, AzureCredential
Conjuntos de parámetros
(All)
Posición: Named Mandatory: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-Location
Especifica la ubicación.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Mandatory: True Valor de la canalización: False Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: False
-MinimumCommitmentDayCount
Número mínimo de días que deben pasar después de la fecha de inicio antes de que se pueda actualizar o eliminar una reserva de capacidad futura una vez confirmada.
Debe ser al menos 30 si se proporciona y, de lo contrario, el valor predeterminado es 30.
Este parámetro solo es válido para Futuras reservas de capacidad.
Versión mínima de la API: 01-04-2026.
Propiedades de parámetro
Tipo: Int32
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Mandatory: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: False
-Name
Especifica el nombre del recurso de reserva de capacidad.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False Alias: CapacityReservationName
Conjuntos de parámetros
(All)
Posición: Named Mandatory: True Valor de la canalización: False Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: False
-ReservationGroupName
Especifica el nombre del grupo de reserva de capacidad.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: True DontShow: False Alias: CapacityReservationGroupName
Conjuntos de parámetros
(All)
Posición: Named Mandatory: True Valor de la canalización: False Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: False
-ResourceGroupName
Especifica el nombre de un grupo de recursos.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Mandatory: True Valor de la canalización: False Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: False
-ScheduleProfileStart
Fecha de inicio necesaria para una reserva de capacidad futura.
Debe ser al menos 7 días y, como máximo, 6 meses en el futuro.
En un grupo de reservas de capacidad dirigida o abierta, proporcionar una fecha de inicio sin una fecha de finalización crea una reserva de capacidad futura.
Versión mínima de la API: 01-04-2026.
Propiedades de parámetro
Tipo: DateTimeOffset
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Mandatory: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: False
-Sku
SKU del recurso para el que se debe reservar la capacidad.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False Alias: Size
Conjuntos de parámetros
(All)
Posición: Named Mandatory: True Valor de la canalización: False Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: False
-Tag
Especifica que los recursos y los grupos de recursos se pueden etiquetar con un conjunto de pares nombre-valor. Agregar etiquetas a recursos le permite agrupar los recursos entre grupos de recursos y crear sus propias vistas. Cada recurso o grupo de recursos puede tener un máximo de 15 etiquetas.
Propiedades de parámetro
Tipo: Hashtable
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Mandatory: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: False
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta.
El cmdlet no se ejecuta.
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None Admite caracteres comodín: False DontShow: False Alias: wi
Conjuntos de parámetros
(All)
Posición: Named Mandatory: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-Zone
Zona de disponibilidad que se usará para esta reserva de capacidad.
Propiedades de parámetro
Tipo: String [ ]
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Mandatory: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters .
Salidas
