Get-AzVmssLifecycleHookEvent
Lista ou recupera eventos de gancho de ciclo de vida para um VMSS (Conjunto de Dimensionamento de Máquinas Virtuais).
Sintaxe
ListParameterSet (Default)
Get-AzVmssLifecycleHookEvent
-ResourceGroupName <String>
-VMScaleSetName <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
GetParameterSet
Get-AzVmssLifecycleHookEvent
-ResourceGroupName <String>
-VMScaleSetName <String>
-Name <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
O cmdlet Get-AzVmssLifecycleHookEvent lista todos os eventos de gancho de ciclo de vida de um VMSS (conjunto de dimensionamento de máquinas virtuais) ou recupera um evento específico por nome (GUID). Os eventos de gancho de ciclo de vida são criados pela plataforma quando os ganchos configurados são acionados durante as fases de Atualização do Sistema Operacional Automático.
Os eventos têm um Properties.State "Ativo" (aguardando uma resposta do cliente) ou "Concluído".
Exemplos
Exemplo 1: Listar todos os eventos de gancho de ciclo de vida para uma VMSS
Get-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss'
Este exemplo lista todos os eventos de gancho de ciclo de vida para o VMSS especificado.
Exemplo 2: Obter um evento específico por nome
Get-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'
Este exemplo recupera um evento de gancho de ciclo de vida específico por seu nome GUID.
Exemplo 3: Filtrar somente para eventos ativos
Get-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' |
Where-Object { $_.Properties.State -eq 'Active' }
Este exemplo lista apenas os eventos de gancho de ciclo de vida ativo.
Exemplo 4: 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 ativos e aprova cada um por meio do pipeline.
Parâmetros
-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 |
-Name
O nome (GUID) do evento de gancho de ciclo de vida a ser recuperado. Quando omitido, todos os eventos para o VMSS são listados.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
GetParameterSet
| 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
(All)
| 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
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| 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.