Set-AzVmssLifecycleHooksProfile
Присоединяет перехватчики жизненного цикла к конфигурации масштабируемого набора виртуальных машин (VMSS) или объекту live VMSS.
Синтаксис
Default (По умолчанию)
Set-AzVmssLifecycleHooksProfile
-VirtualMachineScaleSet <PSVirtualMachineScaleSet>
-LifecycleHook <LifecycleHook[]>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет Set-AzVmssLifecycleHooksProfile подключает перехватчики жизненного цикла к объекту конфигурации VMSS (PSVirtualMachineScaleSet) и возвращает обновленный объект. Это следует стандартному соглашению Az.Compute Builder (аналогично Set-AzVmssOsProfile, Set-AzVmssStorageProfile): он мутирует объект конфигурации VMSS И возвращает его.
Обновленный объект необходимо передать в New-AzVmss (для новых масштабируемых наборов) или Update-AzVmss (для существующих масштабируемых наборов), чтобы сохранить изменения в Azure.
Примеры
Пример 1. Присоединение перехватчика жизненного цикла к новой конфигурации 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
В этом примере создается новая виртуальная машина с присоединенным перехватчиком жизненного цикла.
Пример 2. Добавление перехватчика жизненного цикла в существующую виртуальную машину
$vmss = Get-AzVmss -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss'
$existing = if ($vmss.LifecycleHooksProfile) { $vmss.LifecycleHooksProfile.LifecycleHooks } else { @() }
$batch = New-AzVmssLifecycleHookConfig -Type 'UpgradeAutoOSRollingBatchStarting' -WaitDuration 'PT30M'
$vmss = Set-AzVmssLifecycleHooksProfile -VirtualMachineScaleSet $vmss -LifecycleHook ($existing + $batch)
Update-AzVmss -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -VirtualMachineScaleSet $vmss
В этом примере добавляется второй перехватчик жизненного цикла к существующей виртуальной машине VMSS, сохраняя существующие перехватчики.
Пример 3. Использование конвейера для подключения перехватчиков
$hook = New-AzVmssLifecycleHookConfig -Type 'UpgradeAutoOSScheduling' -WaitDuration 'PT8H'
New-AzVmssConfig -Location 'eastus' -SkuCapacity 2 | Set-AzVmssLifecycleHooksProfile -LifecycleHook $hook
В этом примере конвейер используется для подключения перехватчика жизненного цикла к конфигурации VMSS.
Параметры
-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 |
-LifecycleHook
Один или несколько объектов перехватчика жизненного цикла для подключения к VMSS. Используйте New-AzVmssLifecycleHookConfig для создания объектов перехватчика. Заменяет все существующие перехватчики жизненного цикла в объекте конфигурации VMSS.
Свойства параметров
| Тип: | |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-VirtualMachineScaleSet
Объект конфигурации VMSS (PSVirtualMachineScaleSet) для обновления. Может быть конфигурацией в памяти из New-AzVmssConfig или динамическим объектом VMSS из Get-AzVmss.
Свойства параметров
| Тип: | PSVirtualMachineScaleSet |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | 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.