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.

Свойства параметров

Тип:

LifecycleHook[]

Значение по умолчанию: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.

Входные данные

PSVirtualMachineScaleSet

LifecycleHook

Выходные данные

PSVirtualMachineScaleSet