Update-AzVmssLifecycleHookEvent

Svarar på en VMSS-livscykelkrokhändelse (Virtual Machine Scale Set) genom att godkänna, avvisa eller fördröja den.

Syntax

ByNameParameterSet (Standard)

Update-AzVmssLifecycleHookEvent
    -ResourceGroupName <String>
    -VMScaleSetName <String>
    -Name <String>
    [-ActionState <String>]
    [-InstanceId <String[]>]
    [-WaitUntil <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByObjectParameterSet

Update-AzVmssLifecycleHookEvent
    -InputObject <VMScaleSetLifecycleHookEvent>
    [-ActionState <String>]
    [-InstanceId <String[]>]
    [-WaitUntil <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Cmdleten Update-AzVmssLifecycleHookEvent svarar på en VMSS-livscykelhookhändelse. Du kan:

  • Godkänna eller avvisa händelsen (-ActionState)
  • Godkänna eller avvisa en delmängd av VM-instanser (-InstanceId med -ActionState)
  • Fördröja tidsgränsen för händelsen (-WaitUntil)

Cmdleten accepterar pipelineindata från Get-AzVmssLifecycleHookEvent.

Exempel

Exempel 1: Godkänn alla mål i en händelse

Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -ActionState Approved

I det här exemplet godkänns alla målresurser i livscykelns hook-händelse.

Exempel 2: Avvisa alla mål

Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -ActionState Rejected

I det här exemplet avvisas alla målresurser.

Exempel 3: Godkänn en delmängd av virtuella datorer i en enhetlig VMSS

Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -InstanceId '0','1','2' -ActionState Approved

Det här exemplet godkänner virtuella datorer med instans-ID:n 0, 1 och 2 i en enhetlig VMSS.

Exempel 4: Godkänn en delmängd av virtuella datorer i en Flex VMSS

Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -InstanceId 'myvmss_3ec87a','myvmss_a1b2c3' -ActionState Approved

I det här exemplet godkänns specifika VM-namn i en Flex VMSS.

Exempel 5: Fördröja tidsgränsen för händelsen

Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -WaitUntil '2026-05-08T11:00:00Z'

Det här exemplet fördröjer tidsgränsen för händelsen till den angivna UTC-tidsstämpeln.

Exempel 6: Förhandsgranska vad som skulle godkännas

Update-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' -Name $eventGuid -ActionState Approved -WhatIf

Det här exemplet visar vad cmdleten skulle göra utan att göra några ändringar.

Exempel 7: Godkänn alla aktiva händelser via pipeline

Get-AzVmssLifecycleHookEvent -ResourceGroupName 'myRg' -VMScaleSetName 'myVmss' |
    Where-Object { $_.Properties.State -eq 'Active' } |
    Update-AzVmssLifecycleHookEvent -ActionState Approved

Det här exemplet hämtar alla aktiva livscykelkrokhändelser och godkänner var och en via pipelinen.

Parametrar

-ActionState

Åtgärdstillståndet som ska tillämpas på livscykelns hook-händelsemål. Godkända värden: "Godkänd", "Avvisad".

När -InstanceId inte har angetts tillämpas åtgärden på alla målresurser i händelsen. När -InstanceId anges uppdateras endast matchande mål.

Parameteregenskaper

Typ:String
Standardvärde:None
Godkända värden:Approved, Rejected
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

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

-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

-InputObject

Händelseobjektet för livscykelkroken från "Get-AzVmssLifecycleHookEvent". När du använder den här parameteruppsättningen extraheras resursgruppens namn, VMSS-namn och händelsenamn från objektet.

Parameteregenskaper

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

Parameteruppsättningar

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

-InstanceId

Filtrerar uppdateringen till en delmängd av mål-VM-instans-ID:n (decimal-ID:n för enhetliga VMSS) eller VM-namn (för Flex VMSS). När åtgärden utelämnas tillämpas åtgärdstillståndet på alla målresurser i händelsen.

Parameteregenskaper

Typ:

String[]

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

Parameteruppsättningar

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

-Name

Namnet (GUID) för den livscykelhookhändelse som ska uppdateras.

Parameteregenskaper

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

Parameteruppsättningar

ByNameParameterSet
Position:2
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-ResourceGroupName

Namnet på resursgruppen.

Parameteregenskaper

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

Parameteruppsättningar

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

-VMScaleSetName

Namnet på VM-skalningsuppsättningen.

Parameteregenskaper

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

Parameteruppsättningar

ByNameParameterSet
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

-WaitUntil

Fördröjer tidsgränsen för händelsen till den angivna UTC-tidsstämpeln i ISO 8601-format (till exempel "2026-05-08T11:00:00Z"). Tidsstämpeln får inte överskrida händelsens MaxWaitUntil-värde.

Parameteregenskaper

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

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
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

VMScaleSetLifecycleHookEvent

String

String

Utdata

VMScaleSetLifecycleHookEvent