New-AzVmssLifecycleHookConfig
Crée un objet de configuration de hook de cycle de vie en mémoire à utiliser avec un groupe de machines virtuelles identiques (VMSS).
Syntaxe
Default (Par défaut)
New-AzVmssLifecycleHookConfig
-Type <String>
[-WaitDuration <String>]
[-DefaultAction <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande New-AzVmssLifecycleHookConfig crée un objet de configuration de hook de cycle de vie qui peut être transmis à Set-AzVmssLifecycleHooksProfile ou New-AzVmssConfig.
Les hooks de cycle de vie permettent aux clients d’inscrire des hooks qui se déclenchent avant les phases de mise à niveau du système d’exploitation automatique VMSS, puis de répondre aux événements par machine virtuelle (approuver, rejeter ou retarder) avant que la plateforme ne se poursuive.
Exemples
Exemple 1 : Créer un hook de cycle de vie pour la planification de la mise à niveau du système d’exploitation automatique
$hook = New-AzVmssLifecycleHookConfig -Type 'UpgradeAutoOSScheduling' -WaitDuration 'PT8H'
Cet exemple crée un hook de cycle de vie qui se déclenche avant la planification de la mise à niveau du système d’exploitation automatique, avec une durée d’attente de 8 heures. Comme -DefaultAction il n’est pas spécifié, le service applique sa propre valeur par défaut lorsque la durée d’attente expire.
Exemple 2 : Créer un hook de cycle de vie avec une action par défaut explicite
$hook = New-AzVmssLifecycleHookConfig -Type 'UpgradeAutoOSRollingBatchStarting' -WaitDuration 'PT30M' -DefaultAction 'Approve'
Cet exemple crée un crochet de cycle de vie qui se déclenche avant le démarrage de chaque lot propagé, avec une durée d’attente de 30 minutes et une action par défaut explicite d’Approuver.
Exemple 3 : Utiliser le hook dans un nouveau 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
Cet exemple crée un VMSS avec un hook de cycle de vie attaché.
Paramètres
-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 |
-DefaultAction
Spécifie l’action appliquée à une ressource cible dans l’événement de hook de cycle de vie si la plateforme ne reçoit pas de réponse du client avant l’expiration de la durée d’attente. Valeurs acceptées : « Approuver », « Rejeter ». S’il est omis, le service applique sa propre valeur par défaut.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Valeurs acceptées: | Approve, Reject |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 2 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| 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 |
-Type
Spécifie le type de crochet du cycle de vie. Valeurs possibles : « UpgradeAutoOSScheduling », « UpgradeAutoOSRollingBatchStarting ».
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Valeurs acceptées: | UpgradeAutoOSScheduling, UpgradeAutoOSRollingBatchStarting |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-WaitDuration
Spécifie la durée pendant laquelle l’événement de hook de cycle de vie attend une réponse du client avant d’appliquer l’action par défaut. Doit être au format de durée ISO 8601, par exemple « PT8H » (8 heures) ou « PT30M » (30 minutes).
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: | 1 |
| 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.
