Update-AzVmssLifecycleHookEvent

Répond à un événement de hook de cycle de vie VMSS (Virtual Machine Scale Set) en approuve, rejette ou retarde.

Syntaxe

ByNameParameterSet (Par défaut)

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

L’applet de commande Update-AzVmssLifecycleHookEvent répond à un événement de hook de cycle de vie VMSS. Vous pouvez:

  • Approuver ou rejeter l’événement (-ActionState)
  • Approuver ou rejeter un sous-ensemble d’instances de machine virtuelle (-InstanceId avec -ActionState)
  • Retarder l’échéance de l’événement (-WaitUntil)

L’applet de commande accepte l’entrée de pipeline à partir de Get-AzVmssLifecycleHookEvent.

Exemples

Exemple 1 : Approuver toutes les cibles dans un événement

Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -ActionState Approved

Cet exemple approuve toutes les ressources cibles dans l’événement de hook de cycle de vie.

Exemple 2 : Rejeter toutes les cibles

Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -ActionState Rejected

Cet exemple rejette toutes les ressources cibles.

Exemple 3 : Approuver un sous-ensemble de machines virtuelles dans une machine virtuelle uniforme

Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -InstanceId '0','1','2' -ActionState Approved

Cet exemple approuve les machines virtuelles avec les ID d’instance 0, 1 et 2 dans une machine virtuelle uniforme.

Exemple 4 : Approuver un sous-ensemble de machines virtuelles dans une machine virtuelle Flex VMSS

Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -InstanceId 'myvmss_3ec87a','myvmss_a1b2c3' -ActionState Approved

Cet exemple approuve des noms de machines virtuelles spécifiques dans un service Flex VMSS.

Exemple 5 : Retarder l’échéance de l’événement

Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -WaitUntil '2026-05-08T11:00:00Z'

Cet exemple retarde l’échéance de l’événement à l’horodatage UTC spécifié.

Exemple 6 : Aperçu de ce qui serait approuvé

Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -ActionState Approved -WhatIf

Cet exemple montre ce que l’applet de commande ferait sans apporter de modifications.

Exemple 7 : Approuver tous les événements actifs via le pipeline

Get-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' |
    Where-Object { $_.Properties.State -eq 'Active' } |
    Update-AzVmssLifecycleHookEvent -ActionState Approved

Cet exemple récupère tous les événements de hook de cycle de vie actifs et approuve chacun d’eux via le pipeline.

Paramètres

-ActionState

État d’action à appliquer aux cibles d’événement de hook de cycle de vie. Valeurs acceptées : « Approuvé », « Rejeté ».

Quand -InstanceId elle n’est pas spécifiée, l’action est appliquée à toutes les ressources cibles dans l’événement. Quand -InstanceId elle est spécifiée, seules les cibles correspondantes sont mises à jour.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Valeurs acceptées:Approved, Rejected
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Propriétés du paramètre

Type:IAzureContextContainer
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-InputObject

Objet d’événement de hook de cycle de vie de « Get-AzVmssLifecycleHookEvent ». Lorsque vous utilisez ce jeu de paramètres, le nom du groupe de ressources, le nom vmSS et le nom de l’événement sont extraits de l’objet.

Propriétés du paramètre

Type:VMScaleSetLifecycleHookEvent
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ByObjectParameterSet
Position:0
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-InstanceId

Filtre la mise à jour vers un sous-ensemble d’ID d’instance de machine virtuelle cible (ID décimaux pour vmSS uniformes) ou des noms de machines virtuelles (pour Flex VMSS). En cas d’omission, l’état d’action est appliqué à toutes les ressources cibles dans l’événement.

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Name

Nom (GUID) de l’événement de hook de cycle de vie à mettre à jour.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ByNameParameterSet
Position:2
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-ResourceGroupName

Nom du groupe de ressources.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ByNameParameterSet
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-VMScaleSetName

Nom du groupe de machines virtuelles identiques.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ByNameParameterSet
Position:1
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-WaitUntil

Retarde l’échéance de l’événement au timestamp UTC spécifié au format ISO 8601 (par exemple, « 2026-05-08T11:00:00Z »). L’horodatage ne doit pas dépasser la valeur MaxWaitUntil de l’événement.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

VMScaleSetLifecycleHookEvent

String

String

Sorties

VMScaleSetLifecycleHookEvent