Update-AzVmssLifecycleHookEvent
Responde a um evento de gancho de ciclo de vida do VMSS (Conjunto de Dimensionamento de Máquinas Virtuais) aprovando, rejeitando ou atrasando-o.
Sintaxe
ByNameParameterSet (Default)
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>]
Description
O cmdlet Update-AzVmssLifecycleHookEvent responde a um evento de gancho de ciclo de vida do VMSS. É possível:
- Aprovar ou rejeitar o evento (
-ActionState) - Aprovar ou rejeitar um subconjunto de instâncias de VM (
-InstanceIdcom-ActionState) - Atrasar o prazo do evento (
-WaitUntil)
O cmdlet aceita a entrada de pipeline de Get-AzVmssLifecycleHookEvent.
Exemplos
Exemplo 1: Aprovar todos os destinos em um evento
Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -ActionState Approved
Este exemplo aprova todos os recursos de destino no evento de gancho de ciclo de vida.
Exemplo 2: Rejeitar todos os destinos
Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -ActionState Rejected
Este exemplo rejeita todos os recursos de destino.
Exemplo 3: aprovar um subconjunto de VMs em uma 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 em uma VMSS uniforme.
Exemplo 4: aprovar um subconjunto de VMs em uma VMSS Flex
Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -InstanceId 'myvmss_3ec87a','myvmss_a1b2c3' -ActionState Approved
Este exemplo aprova nomes de VM específicos em uma VMSS Flex.
Exemplo 5: Atrasar a data limite 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 de data/hora UTC especificado.
Exemplo 6: visualizar 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 nenhuma alteração.
Exemplo 7: Aprovar todos os eventos ativos por meio de pipeline
Get-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' |
Where-Object { $_.Properties.State -eq 'Active' } |
Update-AzVmssLifecycleHookEvent -ActionState Approved
Este exemplo recupera todos os eventos de gancho de ciclo de vida ativo e aprova cada um por meio do pipeline.
Parâmetros
-ActionState
O estado de ação a ser aplicado aos destinos de evento do gancho de ciclo de vida. Valores aceitos: 'Aprovado', 'Rejeitado'.
Quando -InstanceId não for especificado, a ação será aplicada a todos os recursos de destino no evento. Quando -InstanceId for especificado, somente os destinos correspondentes serão atualizados.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Valores aceitos: | Approved, Rejected |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usadas para comunicação com Azure.
Propriedades do parâmetro
| Tipo: | IAzureContextContainer |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-InputObject
O objeto de evento de gancho de ciclo de vida de 'Get-AzVmssLifecycleHookEvent'. Ao usar esse conjunto de parâmetros, o nome do grupo de recursos, o nome do VMSS e o nome do evento são extraídos do objeto.
Propriedades do parâmetro
| Tipo: | VMScaleSetLifecycleHookEvent |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ByObjectParameterSet
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-InstanceId
Filtra a atualização para um subconjunto de IDs de instância de VM de destino (IDs decimais para VMSS Uniforme) ou nomes de VM (para VMSS Flex). Quando omitido, o estado da ação é aplicado a todos os recursos de destino no evento.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Name
O nome (GUID) do evento de gancho de ciclo de vida a ser atualizado.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ByNameParameterSet
| Cargo: | 2 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-ResourceGroupName
O nome do grupo de recursos.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ByNameParameterSet
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-VMScaleSetName
O nome do conjunto de dimensionamento da VM.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ByNameParameterSet
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-WaitUntil
Atrasa o prazo do evento para o carimbo de data/hora UTC especificado no formato ISO 8601 (por exemplo, '2026-05-08T11:00:00Z'). O carimbo de data/hora não deve exceder o valor MaxWaitUntil do evento.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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.
