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>]
Описание
Командлет Update-AzVmssLifecycleHookEvent отвечает на событие перехватчика жизненного цикла VMSS. Можно сделать следующее:
- Утверждение или отклонение события (
-ActionState) - Утверждение или отклонение подмножества экземпляров виртуальных машин (
-InstanceIdс )-ActionState - Задержка срока события (
-WaitUntil)
Командлет принимает входные данные конвейера из Get-AzVmssLifecycleHookEvent.
Примеры
Пример 1. Утверждение всех целевых объектов в событии
Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -ActionState Approved
Этот пример утверждает все целевые ресурсы в событии перехватчика жизненного цикла.
Пример 2. Отклонение всех целевых объектов
Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -ActionState Rejected
В этом примере отклоняется все целевые ресурсы.
Пример 3. Утверждение подмножества виртуальных машин в универсальной виртуальной машине
Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -InstanceId '0','1','2' -ActionState Approved
В этом примере виртуальные машины утверждаются с идентификаторами экземпляров 0, 1 и 2 в универсальной виртуальной машине.
Пример 4. Утверждение подмножества виртуальных машин в Flex VMSS
Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -InstanceId 'myvmss_3ec87a','myvmss_a1b2c3' -ActionState Approved
В этом примере утверждены определенные имена виртуальных машин в flex VMSS.
Пример 5. Задержка крайнего срока события
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 |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Confirm
Запрашивает подтверждение перед запуском cmdlet.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | Cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DefaultProfile
Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.
Свойства параметров
| Тип: | IAzureContextContainer |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-InputObject
Объект события перехватчика жизненного цикла из get-AzVmssLifecycleHookEvent. При использовании этого набора параметров имя группы ресурсов, имя vmSS и имя события извлекаются из объекта.
Свойства параметров
| Тип: | VMScaleSetLifecycleHookEvent |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
ByObjectParameterSet
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-InstanceId
Фильтрует обновление до подмножества идентификаторов экземпляров целевой виртуальной машины (десятичные идентификаторы для универсальных виртуальных машин) или имен виртуальных машин (для Flex VMSS). При опущении состояние действия применяется ко всем целевым ресурсам в событии.
Свойства параметров
| Тип: | String[] |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Name
Имя (GUID) события перехватчика жизненного цикла для обновления.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
ByNameParameterSet
| Position: | 2 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-ResourceGroupName
Имя группы ресурсов.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
ByNameParameterSet
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-VMScaleSetName
Имя масштабируемого набора виртуальных машин.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
ByNameParameterSet
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-WaitUntil
Задерживает крайний срок события до указанной метки времени UTC в формате ISO 8601 (например, "2026-05-08T11:00:00Z". Метка времени не должна превышать значение MaxWaitUntil события.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-WhatIf
Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | Wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
