Set-AzVmssLifecycleHooksProfile

Koppelt levenscyclushook aan een VMSS-configuratie (Virtual Machine Scale Set) of live VMSS-object.

Syntax

Default (Standaard)

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

Description

De cmdlet Set-AzVmssLifecycleHooksProfile koppelt levenscyclushooken aan een VMSS-configuratieobject (PSVirtualMachineScaleSet) en retourneert het bijgewerkte object. Dit volgt de standaard Az.Compute Builder-conventie (hetzelfde als Set-AzVmssOsProfile, Set-AzVmssStorageProfile): het muteert het VMSS-configuratieobject en retourneert het.

Het bijgewerkte object moet worden doorgegeven aan New-AzVmss (voor nieuwe schaalsets) of Update-AzVmss (voor bestaande schaalsets) om de wijzigingen in Azure te behouden.

Voorbeelden

Voorbeeld 1: Een levenscyclushook koppelen aan een nieuwe VMSS-configuratie

$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

In dit voorbeeld wordt een nieuwe VMSS gemaakt met een gekoppelde levenscyclushook.

Voorbeeld 2: Een levenscyclushook toevoegen aan een bestaande VMSS

$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

In dit voorbeeld wordt een tweede levenscyclushook toegevoegd aan een bestaande VMSS, waarbij de bestaande hooks behouden blijven.

Voorbeeld 3: Pijplijn gebruiken om haken te koppelen

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

In dit voorbeeld wordt de pijplijn gebruikt om een levenscyclushook te koppelen aan een VMSS-configuratie.

Parameters

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Cf

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Parametereigenschappen

Type:IAzureContextContainer
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AzContext, AzureRmContext, AzureCredential

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-LifecycleHook

Een of meer levenscyclushookobjecten die aan de VMSS moeten worden gekoppeld. Gebruik New-AzVmssLifecycleHookConfig om hook-objecten te maken. Vervangt eventuele bestaande levenscyclushook op het CONFIGURATIEobject van VMSS.

Parametereigenschappen

Type:

LifecycleHook[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:1
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-VirtualMachineScaleSet

Het VMSS-configuratieobject (PSVirtualMachineScaleSet) dat moet worden bijgewerkt. Dit kan een in-memory configuratie zijn van 'New-AzVmssConfig' of een live VMSS-object van 'Get-AzVmss'.

Parametereigenschappen

Type:PSVirtualMachineScaleSet
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:0
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-WhatIf

Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Wi

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

PSVirtualMachineScaleSet

LifecycleHook

Uitvoerwaarden

PSVirtualMachineScaleSet