Set-AzVmssLifecycleHooksProfile
Anexa ganchos do ciclo de vida a uma configuração VMSS (Virtual Machine Scale Set) ou a um objeto VMSS em funcionamento.
Sintaxe
Default (Predefinição)
Set-AzVmssLifecycleHooksProfile
-VirtualMachineScaleSet <PSVirtualMachineScaleSet>
-LifecycleHook <LifecycleHook[]>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrição
O cmdlet Set-AzVmssLifecycleHooksProfile anexa ganchos do ciclo de vida a um objeto de configuração VMSS (PSVirtualMachineScaleSet) e devolve o objeto atualizado. Isto segue a convenção padrão do Az.Compute builder (igual ao Set-AzVmssOsProfile, Set-AzVmssStorageProfile): muta o objeto de configuração VMSS E devolve-o.
O objeto atualizado deve ser passado para New-AzVmss (para novos conjuntos de escala) ou Update-AzVmss (para conjuntos de escala existentes) para persistir as alterações no Azure.
Exemplos
Exemplo 1: Anexar um gancho de ciclo de vida a uma nova configuração 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
Este exemplo cria um novo VMSS com um gancho de ciclo de vida anexado.
Exemplo 2: Adicionar um gancho de ciclo de vida a um 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
Este exemplo adiciona um segundo hook do ciclo de vida a um VMSS existente, preservando os hooks existentes.
Exemplo 3: Usar pipeline para fixar ganchos
$hook = New-AzVmssLifecycleHookConfig -Type 'UpgradeAutoOSScheduling' -WaitDuration 'PT8H'
New-AzVmssConfig -Location 'eastus' -SkuCapacity 2 | Set-AzVmssLifecycleHooksProfile -LifecycleHook $hook
Este exemplo utiliza o pipeline para anexar um gancho de ciclo de vida a uma configuração VMSS.
Parâmetros
-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 |
-LifecycleHook
Um ou mais objetos hook do ciclo de vida para anexar ao VMSS. Use 'New-AzVmssLifecycleHookConfig' para criar objetos hook. Substitui quaisquer ganchos de ciclo de vida existentes no objeto de configuração VMSS.
Propriedades dos parâmetros
| Tipo: | |
| Valor predefinido: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Posto: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-VirtualMachineScaleSet
O objeto de configuração VMSS (PSVirtualMachineScaleSet) para atualizar. Pode ser uma configuração em memória a partir de 'New-AzVmssConfig' ou um objeto VMSS ao vivo de 'Get-AzVmss'.
Propriedades dos parâmetros
| Tipo: | PSVirtualMachineScaleSet |
| Valor predefinido: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Posto: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| 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 |
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.
