Update-AzVmssLifecycleHookEvent
對虛擬機擴展集（VMSS）生命週期掛鉤事件進行回應，可批准、拒絕或延遲。
語法
ByNameParameterSet (預設值)
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
Update-AzVmssLifeCycleHookEvent 指令檔會回應 VMSS 生命週期鉤子事件。 您可以：
- 批准或拒絕事件 （
-ActionState） - 批准或拒絕部分虛擬機實例（
-InstanceId，且-ActionState） - 延後活動截止日期（
-WaitUntil）
該 cmdlet 接受來自 Get-AzVmssLifecycleHookEvent 的管線輸入。
範例
範例 1：批准事件中的所有目標
Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -ActionState Approved
此範例批准生命週期鉤子事件中的所有目標資源。
範例二：拒絕所有目標
Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -ActionState Rejected
此範例拒絕所有目標資源。
範例 3：在統一 VMSS 中批准部分虛擬機
Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -InstanceId '0','1','2' -ActionState Approved
此範例批准了實例 ID 為 0、1 和 2 的虛擬機，並以統一 VMSS。
範例 4：在 Flex VMSS 中核准部分虛擬機
Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -InstanceId 'myvmss_3ec87a','myvmss_a1b2c3' -ActionState Approved
此範例用於核准 Flex VMSS 中的特定虛擬機名稱。
範例五：延遲事件截止日期
Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -WaitUntil '2026-05-08T11:00:00Z'
此範例將事件截止日期延遲至指定的 UTC 時間戳記。
範例 6：預覽將被核准的內容
Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -ActionState Approved -WhatIf
這個例子展示了指令小程式在不做任何修改的情況下會做什麼。
範例 7：透過管線批准所有活躍事件
Get-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' |
Where-Object { $_.Properties.State -eq 'Active' } |
Update-AzVmssLifecycleHookEvent -ActionState Approved
此範例會檢索所有活躍的生命週期鉤子事件，並透過管線批准每個事件。
參數
-ActionState
動作狀態將套用到生命週期鉤子事件目標上。 接受的值：「批准」、「拒絕」。
若 -InstanceId 未指定，則該動作會套用到事件中的所有目標資源。 當 -InstanceId 指定時，僅更新匹配的目標。
參數屬性
| 類型: | String |
| 預設值: | None |
| 接受的值: | Approved, Rejected |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Confirm
在執行 Cmdlet 之前，提示您進行確認。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 參見 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DefaultProfile
用於與 Azure 通訊的憑證、帳號、租戶和訂閱。
參數屬性
| 類型: | IAzureContextContainer |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | AzContext, AzureRmContext, AzureCredential |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-InputObject
來自「Get-AzVmssLifecycleHookEvent」的生命週期鉤子事件物件。 使用此參數時，資源群組名稱、VMSS 名稱及事件名稱會從物件中擷取。
參數屬性
| 類型: | VMScaleSetLifecycleHookEvent |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ByObjectParameterSet
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-InstanceId
將更新過濾為目標虛擬實例 ID 子集（統一 VMSS 為十進位 ID）或虛擬機名稱（對 Flex VMSS）。 若省略，動作狀態會套用到事件中的所有目標資源。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Name
要更新的生命週期鉤子事件名稱（GUID）。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ByNameParameterSet
| Position: | 2 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-ResourceGroupName
資源群組的名稱。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ByNameParameterSet
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-VMScaleSetName
VM 擴展集的名稱。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ByNameParameterSet
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-WaitUntil
將事件截止日期延遲至指定的 UTC 時間戳記（ISO 8601 格式）（例如「2026-05-08T11：00：00Z」）。 時間戳記不得超過事件的最大等待值。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。 指令未執行。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 威斯康辛 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
