Set-AzVmssLifecycleHooksProfile
Asocia enlaces de ciclo de vida a una configuración del conjunto de escalado de máquinas virtuales (VMSS) o a un objeto VMSS activo.
Sintaxis
Default (valor predeterminado)
Set-AzVmssLifecycleHooksProfile
-VirtualMachineScaleSet <PSVirtualMachineScaleSet>
-LifecycleHook <LifecycleHook[]>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
El cmdlet Set-AzVmssLifecycleHooksProfile asocia enlaces de ciclo de vida a un objeto de configuración de VMSS (PSVirtualMachineScaleSet) y devuelve el objeto actualizado. Esto sigue la convención estándar de Az.Compute Builder (igual que Set-AzVmssOsProfile, Set-AzVmssStorageProfile): muta el objeto de configuración de VMSS Y lo devuelve.
El objeto actualizado debe pasarse a New-AzVmss (para nuevos conjuntos de escalado) o Update-AzVmss (para conjuntos de escalado existentes) para conservar los cambios en Azure.
Ejemplos
Ejemplo 1: Asociación de un enlace de ciclo de vida a una nueva configuración de VMSS
$hook = New-AzVmssLifecycleHookConfig -Type 'UpgradeAutoOSScheduling' -WaitDuration 'PT8H'
$config = New-AzVmssConfig -Location 'eastus' -SkuCapacity 2
$config = Set-AzVmssLifecycleHooksProfile -VirtualMachineScaleSet $config -LifecycleHook $hook
New-AzVmss -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -VirtualMachineScaleSet $config
En este ejemplo se crea un nuevo VMSS con un enlace de ciclo de vida conectado.
Ejemplo 2: Adición de un enlace de ciclo de vida a un VMSS existente
$vmss = Get-AzVmss -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss'
$existing = if ($vmss.LifecycleHooksProfile) { $vmss.LifecycleHooksProfile.LifecycleHooks } else { @() }
$batch = New-AzVmssLifecycleHookConfig -Type 'UpgradeAutoOSRollingBatchStarting' -WaitDuration 'PT30M'
$vmss = Set-AzVmssLifecycleHooksProfile -VirtualMachineScaleSet $vmss -LifecycleHook ($existing + $batch)
Update-AzVmss -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -VirtualMachineScaleSet $vmss
En este ejemplo se agrega un segundo enlace de ciclo de vida a un VMSS existente y se conservan los enlaces existentes.
Ejemplo 3: Uso de la canalización para adjuntar enlaces
$hook = New-AzVmssLifecycleHookConfig -Type 'UpgradeAutoOSScheduling' -WaitDuration 'PT8H'
New-AzVmssConfig -Location 'eastus' -SkuCapacity 2 | Set-AzVmssLifecycleHooksProfile -LifecycleHook $hook
En este ejemplo se usa la canalización para asociar un enlace de ciclo de vida a una configuración de VMSS.
Parámetros
-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 |
| Obligatorio: | 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 |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-LifecycleHook
Uno o varios objetos de enlace del ciclo de vida que se van a asociar a VMSS. Use "New-AzVmssLifecycleHookConfig" para crear objetos de enlace. Reemplaza los enlaces de ciclo de vida existentes en el objeto de configuración de VMSS.
Propiedades de parámetro
| Tipo: | |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 1 |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-VirtualMachineScaleSet
Objeto de configuración de VMSS (PSVirtualMachineScaleSet) que se va a actualizar. Puede ser una configuración en memoria desde "New-AzVmssConfig" o un objeto VMSS activo desde "Get-AzVmss".
Propiedades de parámetro
| Tipo: | PSVirtualMachineScaleSet |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 0 |
| Obligatorio: | True |
| Valor de la canalización: | True |
| 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 |
| Obligatorio: | 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.
