Update-AzVmssLifecycleHookEvent
Antwortet auf ein VMSS-Lebenszyklus-Hook-Ereignis (Virtual Machine Scale Set), indem er es genehmigt, abgelehnt oder verzögert.
Syntax
ByNameParameterSet (Standard)
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>]
Beschreibung
Das Cmdlet Update-AzVmssLifecycleHookEvent antwortet auf ein VMSS-Lifecycle-Hook-Ereignis. Sie haben folgende Möglichkeiten:
- Genehmigen oder Ablehnen des Ereignisses (
-ActionState) - Genehmigen oder Ablehnen einer Teilmenge von VM-Instanzen (
-InstanceIdmit-ActionState) - Verzögern des Stichtags des Ereignisses (
-WaitUntil)
Das Cmdlet akzeptiert Pipelineeingaben von Get-AzVmssLifecycleHookEvent.
Beispiele
Beispiel 1: Genehmigen aller Ziele in einem Ereignis
Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -ActionState Approved
In diesem Beispiel werden alle Zielressourcen im Lifecycle Hook-Ereignis genehmigt.
Beispiel 2: Alle Ziele ablehnen
Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -ActionState Rejected
In diesem Beispiel werden alle Zielressourcen abgelehnt.
Beispiel 3: Genehmigen einer Teilmenge von VMs in einem uniform VMSS
Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -InstanceId '0','1','2' -ActionState Approved
In diesem Beispiel werden virtuelle Computer mit Instanz-IDs 0, 1 und 2 in einem uniform VMSS genehmigt.
Beispiel 4: Genehmigen einer Teilmenge von VMs in einem Flex VMSS
Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -InstanceId 'myvmss_3ec87a','myvmss_a1b2c3' -ActionState Approved
In diesem Beispiel werden bestimmte VM-Namen in einem Flex VMSS genehmigt.
Beispiel 5: Verzögern des Termins des Ereignisses
Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -WaitUntil '2026-05-08T11:00:00Z'
In diesem Beispiel wird der Stichtag des Ereignisses auf den angegebenen UTC-Zeitstempel verzögert.
Beispiel 6: Anzeigen einer Vorschau, was genehmigt werden würde
Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -ActionState Approved -WhatIf
In diesem Beispiel wird gezeigt, was das Cmdlet tun würde, ohne Änderungen vorzunehmen.
Beispiel 7: Genehmigen aller aktiven Ereignisse über die Pipeline
Get-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' |
Where-Object { $_.Properties.State -eq 'Active' } |
Update-AzVmssLifecycleHookEvent -ActionState Approved
In diesem Beispiel werden alle aktiven Lebenszyklus-Hook-Ereignisse abgerufen und die einzelnen Ereignisse über die Pipeline genehmigt.
Parameter
-ActionState
Der Aktionsstatus, der auf die Lebenszyklus-Hook-Ereignisziele angewendet werden soll. Akzeptierte Werte: 'Genehmigt', 'Abgelehnt'.
Wenn -InstanceId nicht angegeben, wird die Aktion auf alle Zielressourcen im Ereignis angewendet. Wenn -InstanceId angegeben, werden nur die übereinstimmenden Ziele aktualisiert.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Zulässige Werte: | Approved, Rejected |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Confirm
Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Cf |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-DefaultProfile
Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.
Parametereigenschaften
| Typ: | IAzureContextContainer |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | AzContext, AzureRmContext, AzureCredential |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-InputObject
Das Lebenszyklus-Hook-Ereignisobjekt von "Get-AzVmssLifecycleHookEvent". Bei Verwendung dieses Parametersatzes werden der Ressourcengruppenname, der VMSS-Name und der Ereignisname aus dem Objekt extrahiert.
Parametereigenschaften
| Typ: | VMScaleSetLifecycleHookEvent |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ByObjectParameterSet
| Position: | 0 |
| Obligatorisch: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-InstanceId
Filtert das Update auf eine Teilmenge von Ziel-VM-Instanz-IDs (Dezimal-IDs für uniform VMSS) oder VM-Namen (für Flex VMSS). Wenn sie weggelassen wird, wird der Aktionszustand auf alle Zielressourcen im Ereignis angewendet.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Name
Der Name (GUID) des zu aktualisierenden Lebenszyklus-Hook-Ereignisses.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ByNameParameterSet
| Position: | 2 |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-ResourceGroupName
Der Name der Ressourcengruppe.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ByNameParameterSet
| Position: | 0 |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-VMScaleSetName
Der Name des VM-Skalierungssatzes.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ByNameParameterSet
| Position: | 1 |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-WaitUntil
Verzögert den Ereignistermin auf den angegebenen UTC-Zeitstempel im ISO 8601-Format (z. B. "2026-05-08T11:00:00Z"). Der Zeitstempel darf den MaxWaitUntil-Wert des Ereignisses nicht überschreiten.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
