Set-AzVmssLifecycleHooksProfile

Kopplar livscykelkrokar till en VMSS-konfiguration (VmSS) eller live-VMSS-objekt.

Syntax

Default (Standard)

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

Description

Cmdleten Set-AzVmssLifecycleHooksProfile kopplar livscykelkrokar till ett VMSS-konfigurationsobjekt (PSVirtualMachineScaleSet) och returnerar det uppdaterade objektet. Detta följer az.compute builder-standardkonventionen (samma som Set-AzVmssOsProfile, Set-AzVmssStorageProfile): den muterar VMSS-konfigurationsobjektet och returnerar det.

Det uppdaterade objektet måste skickas till New-AzVmss (för nya skalningsuppsättningar) eller Update-AzVmss (för befintliga skalningsuppsättningar) för att spara ändringarna i Azure.

Exempel

Exempel 1: Koppla en livscykelkrok till en ny VMSS-konfiguration

$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

I det här exemplet skapas en ny VMSS med en ansluten livscykelkrok.

Exempel 2: Lägg till en livscykelkrok till en befintlig 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

Det här exemplet lägger till en andra livscykelkrok till en befintlig VMSS, vilket bevarar de befintliga krokarna.

Exempel 3: Använd pipeline för att koppla krokar

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

I det här exemplet används pipelinen för att koppla en livscykelkrok till en VMSS-konfiguration.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Parameteregenskaper

Typ:IAzureContextContainer
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-LifecycleHook

Ett eller flera livscykelkrokobjekt som ska kopplas till VMSS. Använd "New-AzVmssLifecycleHookConfig" för att skapa hook-objekt. Ersätter alla befintliga livscykelkrokar på VMSS-konfigurationsobjektet.

Parameteregenskaper

Typ:

LifecycleHook[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:1
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-VirtualMachineScaleSet

VMSS-konfigurationsobjektet (PSVirtualMachineScaleSet) som ska uppdateras. Kan vara en minnesintern konfiguration från "New-AzVmssConfig" eller ett LIVE VMSS-objekt från "Get-AzVmss".

Parameteregenskaper

Typ:PSVirtualMachineScaleSet
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:0
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-WhatIf

Visar vad som skulle hända om kommandot körs. Cmdleten körs inte.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

PSVirtualMachineScaleSet

LifecycleHook

Utdata

PSVirtualMachineScaleSet