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: | |
| 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.