Update-AzVmssLifecycleHookEvent
Odpowiada na zdarzenie punkt zaczepienia zestawu skalowania maszyn wirtualnych (VMSS), zatwierdzając, odrzucając lub opóźniając go.
Składnia
ByNameParameterSet (domyślnie)
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>]
Opis
Polecenie cmdlet Update-AzVmssLifecycleHookEvent odpowiada na zdarzenie punktu zaczepienia cyklu życia zestawu skalowania maszyn wirtualnych. Masz następujące możliwości:
- Zatwierdzanie lub odrzucanie zdarzenia (
-ActionState) - Zatwierdzanie lub odrzucanie podzestawu wystąpień maszyn wirtualnych (
-InstanceIdz-ActionState) - Opóźnienie terminu ostatecznego zdarzenia (
-WaitUntil)
Polecenie cmdlet akceptuje dane wejściowe potoku z polecenia Get-AzVmssLifecycleHookEvent.
Przykłady
Przykład 1: Zatwierdzanie wszystkich obiektów docelowych w zdarzeniu
Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -ActionState Approved
W tym przykładzie wszystkie zasoby docelowe są zatwierdzane w zdarzeniu punktów zaczepienia cyklu życia.
Przykład 2. Odrzucanie wszystkich elementów docelowych
Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -ActionState Rejected
Ten przykład odrzuca wszystkie zasoby docelowe.
Przykład 3. Zatwierdzanie podzbioru maszyn wirtualnych w jednolitych zestawach skalowania maszyn wirtualnych
Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -InstanceId '0','1','2' -ActionState Approved
W tym przykładzie maszyny wirtualne zatwierdzają identyfikatory wystąpień 0, 1 i 2 w ujednoliconym zestawie skalowania maszyn wirtualnych.
Przykład 4. Zatwierdzanie podzbioru maszyn wirtualnych w zestawie elastycznych maszyn wirtualnych
Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -InstanceId 'myvmss_3ec87a','myvmss_a1b2c3' -ActionState Approved
W tym przykładzie zatwierdzane są określone nazwy maszyn wirtualnych w zestawie flex VMSS.
Przykład 5. Opóźnienie terminu ostatecznego zdarzenia
Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -WaitUntil '2026-05-08T11:00:00Z'
W tym przykładzie termin zdarzenia jest opóźniony do określonego znacznika czasu UTC.
Przykład 6. Podgląd zatwierdzonego elementu
Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -ActionState Approved -WhatIf
W tym przykładzie pokazano, co można zrobić za pomocą polecenia cmdlet bez wprowadzania żadnych zmian.
Przykład 7. Zatwierdzanie wszystkich aktywnych zdarzeń za pośrednictwem potoku
Get-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' |
Where-Object { $_.Properties.State -eq 'Active' } |
Update-AzVmssLifecycleHookEvent -ActionState Approved
Ten przykład pobiera wszystkie aktywne zdarzenia punktów zaczepienia cyklu życia i zatwierdza je za pośrednictwem potoku.
Parametry
-ActionState
Stan akcji, który ma być stosowany do docelowych zdarzeń punktów zaczepienia cyklu życia. Zaakceptowane wartości: "Zatwierdzone", "Odrzucone".
Jeśli -InstanceId nie zostanie określona, akcja zostanie zastosowana do wszystkich zasobów docelowych w zdarzeniu. Gdy -InstanceId zostanie określony, zostaną zaktualizowane tylko pasujące elementy docelowe.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Dopuszczalne wartości: | Approved, Rejected |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-Confirm
Prosi o potwierdzenie przed uruchomieniem cmdletu.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | por |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-DefaultProfile
Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z Azure.
Właściwości parametru
| Typ: | IAzureContextContainer |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | AzContext, AzureRmContext, AzureCredential |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-InputObject
Obiekt zdarzenia haka cyklu życia z polecenia "Get-AzVmssLifecycleHookEvent". W przypadku korzystania z tego zestawu parametrów nazwa grupy zasobów, nazwa zestawu skalowania maszyn wirtualnych i nazwa zdarzenia są wyodrębniane z obiektu.
Właściwości parametru
| Typ: | VMScaleSetLifecycleHookEvent |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
ByObjectParameterSet
| Position: | 0 |
| Obowiązkowy: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-InstanceId
Filtruje aktualizację do podzestawu docelowych identyfikatorów wystąpień maszyn wirtualnych (identyfikatorów dziesiętnych dla uniform VMSS) lub nazw maszyn wirtualnych (dla flex VMSS). Po pominięciu stan akcji jest stosowany do wszystkich zasobów docelowych w zdarzeniu.
Właściwości parametru
| Typ: | String[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-Name
Nazwa (GUID) zdarzenia punktu zaczepienia cyklu życia do zaktualizowania.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
ByNameParameterSet
| Position: | 2 |
| Obowiązkowy: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-ResourceGroupName
Nazwa grupy zasobów.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
ByNameParameterSet
| Position: | 0 |
| Obowiązkowy: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-VMScaleSetName
Nazwa zestawu skalowania maszyn wirtualnych.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
ByNameParameterSet
| Position: | 1 |
| Obowiązkowy: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-WaitUntil
Opóźnia termin zdarzenia do określonego znacznika czasu UTC w formacie ISO 8601 (na przykład "2026-05-08T11:00:00Z"). Znacznik czasu nie może przekraczać wartości MaxWaitUntil zdarzenia.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Wi |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
