Update-AzVmssLifecycleHookEvent
Responde a um evento de ciclo de vida do Virtual Machine Scale Set (VMSS) aprovando, rejeitando ou adiando-o.
Sintaxe
ByNameParameterSet (Predefinição)
Update-AzVmssLifecycleHookEvent
-ResourceGroupName <String>
-VMScaleSetName <String>
-Name <String>
[-ActionState <String>]
[-InstanceId <String[]>]
[-WaitUntil <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObjectParameterSet
Update-AzVmssLifecycleHookEvent
-InputObject <VMScaleSetLifecycleHookEvent>
[-ActionState <String>]
[-InstanceId <String[]>]
[-WaitUntil <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrição
O cmdlet Update-AzVmssLifecycleHookEvent responde a um evento de hook do ciclo de vida VMSS. É possível:
- Aprovar ou rejeitar o evento (
-ActionState) - Aprovar ou rejeitar um subconjunto de instâncias de VM (
-InstanceIdcom-ActionState) - Adiar o prazo do evento (
-WaitUntil)
O cmdlet aceita entrada do pipeline do Get-AzVmssLifecycleHookEvent.
Exemplos
Exemplo 1: Aprovar todos os alvos num evento
Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -ActionState Approved
Este exemplo aprova todos os recursos-alvo no evento do gancho do ciclo de vida.
Exemplo 2: Rejeitar todos os alvos
Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -ActionState Rejected
Este exemplo rejeita todos os recursos-alvo.
Exemplo 3: Aprovar um subconjunto de VMs num VMSS Uniforme
Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -InstanceId '0','1','2' -ActionState Approved
Este exemplo aprova VMs com IDs de instância 0, 1 e 2 num VMSS Uniforme.
Exemplo 4: Aprovar um subconjunto de VMs num Flex VMSS
Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -InstanceId 'myvmss_3ec87a','myvmss_a1b2c3' -ActionState Approved
Este exemplo aprova nomes específicos de VMs num VMSS Flex.
Exemplo 5: Adiar o prazo do evento
Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -WaitUntil '2026-05-08T11:00:00Z'
Este exemplo atrasa o prazo do evento para o carimbo temporal UTC especificado.
Exemplo 6: Pré-visualize o que seria aprovado
Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -ActionState Approved -WhatIf
Este exemplo mostra o que o cmdlet faria sem fazer quaisquer alterações.
Exemplo 7: Aprovar todos os eventos ativos via pipeline
Get-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' |
Where-Object { $_.Properties.State -eq 'Active' } |
Update-AzVmssLifecycleHookEvent -ActionState Approved
Este exemplo recupera todos os eventos ativos do ciclo de vida e aprova cada um através do pipeline.
Parâmetros
-ActionState
O estado de ação a aplicar aos alvos do evento do gancho de ciclo de vida. Valores aceites: 'Aprovado', 'Rejeitado'.
Quando -InstanceId não é especificado, a ação é aplicada a todos os recursos-alvo do evento. Quando -InstanceId é especificado, apenas os alvos correspondentes são atualizados.
Propriedades dos parâmetros
| Tipo: | String |
| Valor predefinido: | None |
| Valores aceites: | Approved, Rejected |
| 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 |
-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 |
-InputObject
O objeto evento gancho do ciclo de vida de 'Get-AzVmssLifecycleHookEvent'. Ao usar este conjunto de parâmetros, o nome do grupo de recursos, o nome VMSS e o nome do evento são extraídos do objeto.
Propriedades dos parâmetros
| Tipo: | VMScaleSetLifecycleHookEvent |
| Valor predefinido: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
ByObjectParameterSet
| Posto: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-InstanceId
Filtra a atualização para um subconjunto de IDs de instância de VM alvo (IDs decimais para Uniform VMSS) ou nomes de VM (para Flex VMSS). Quando omitido, o estado da ação é aplicado a todos os recursos-alvo no evento.
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: | True |
| Valor dos restantes argumentos: | False |
-Name
O nome (GUID) do evento do gancho do ciclo de vida a atualizar.
Propriedades dos parâmetros
| Tipo: | String |
| Valor predefinido: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
ByNameParameterSet
| Posto: | 2 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-ResourceGroupName
O nome do grupo de recursos.
Propriedades dos parâmetros
| Tipo: | String |
| Valor predefinido: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
ByNameParameterSet
| Posto: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-VMScaleSetName
O nome do conjunto de escala de VM.
Propriedades dos parâmetros
| Tipo: | String |
| Valor predefinido: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
ByNameParameterSet
| Posto: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-WaitUntil
Atrasa o prazo do evento para o carimbo temporal UTC especificado no formato ISO 8601 (por exemplo, '2026-05-08T11:00:00Z'). O carimbo temporal não pode exceder o valor MaxWaitUntil do evento.
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: | 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.
