Set-AzVmssLifecycleHooksProfile

Dołącza zaczepienia cyklu życia do konfiguracji zestawu skalowania maszyn wirtualnych (VMSS) lub obiektu live VMSS.

Składnia

Default (domyślnie)

Set-AzVmssLifecycleHooksProfile
    -VirtualMachineScaleSet <PSVirtualMachineScaleSet>
    -LifecycleHook <LifecycleHook[]>
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Opis

Polecenie cmdlet Set-AzVmssLifecycleHooksProfile dołącza zaczepienia cyklu życia do obiektu konfiguracji zestawu skalowania maszyn wirtualnych (PSVirtualMachineScaleSet) i zwraca zaktualizowany obiekt. Jest to zgodne ze standardową konwencją konstruktora Az.Compute (taką samą jak Set-AzVmssOsProfile, Set-AzVmssStorageProfile): wycisza obiekt konfiguracji zestawu skalowania maszyn wirtualnych i zwraca go.

Zaktualizowany obiekt musi zostać przekazany do polecenia New-AzVmss (dla nowych zestawów skalowania) lub Update-AzVmsss (dla istniejących zestawów skalowania), aby utrwalić zmiany w Azure.

Przykłady

Przykład 1. Dołączanie elementu zaczepienia cyklu życia do nowej konfiguracji zestawu skalowania maszyn wirtualnych

$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

W tym przykładzie zostanie utworzony nowy zestaw skalowania maszyn wirtualnych z dołączonym elementem zaczepienia cyklu życia.

Przykład 2. Dodawanie elementu zaczepienia cyklu życia do istniejącego zestawu skalowania maszyn wirtualnych

$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

W tym przykładzie dodano drugi punkt zaczepienia cyklu życia do istniejącego zestawu skalowania maszyn wirtualnych, zachowując istniejące zaczepienia.

Przykład 3. Dołączanie punktów zaczepienia przy użyciu potoku

$hook = New-AzVmssLifecycleHookConfig -Type 'UpgradeAutoOSScheduling' -WaitDuration 'PT8H'
New-AzVmssConfig -Location 'eastus' -SkuCapacity 2 | Set-AzVmssLifecycleHooksProfile -LifecycleHook $hook

W tym przykładzie potok jest używany do dołączania elementu zaczepienia cyklu życia do konfiguracji zestawu skalowania maszyn wirtualnych.

Parametry

-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

-LifecycleHook

Co najmniej jeden obiekt zaczepienia cyklu życia, który ma zostać dołączony do zestawu skalowania maszyn wirtualnych. Użyj polecenia "New-AzVmssLifecycleHookConfig", aby utworzyć obiekty zaczepienia. Zastępuje wszystkie istniejące elementy zaczepienia cyklu życia obiektu konfiguracji zestawu skalowania maszyn wirtualnych.

Właściwości parametru

Typ:

LifecycleHook[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
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

-VirtualMachineScaleSet

Obiekt konfiguracji zestawu skalowania maszyn wirtualnych (PSVirtualMachineScaleSet) do aktualizacji. Może być konfiguracją w pamięci z polecenia "New-AzVmssConfig" lub obiektem live VMSS z polecenia "Get-AzVmss".

Właściwości parametru

Typ:PSVirtualMachineScaleSet
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:0
Obowiązkowy:True
Wartość z potoku:True
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.

Dane wejściowe

PSVirtualMachineScaleSet

LifecycleHook

Dane wyjściowe

PSVirtualMachineScaleSet