New-AzVmssLifecycleHookConfig

Erstellt ein In-Memory-Lifecycle-Hook-Konfigurationsobjekt für die Verwendung mit einem VMSS-Skalierungssatz (Virtual Machine Scale Set).

Syntax

Default (Standard)

New-AzVmssLifecycleHookConfig
    -Type <String>
    [-WaitDuration <String>]
    [-DefaultAction <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Beschreibung

Mit dem Cmdlet New-AzVmssLifecycleHookConfig wird ein Lebenszyklus-Hook-Konfigurationsobjekt erstellt, das an Set-AzVmssLifecycleHooksProfile oder New-AzVmssConfig übergeben werden kann.

Mit Lebenszyklus-Hooks können Kunden Hooks registrieren, die vor vmSS-Automatischen Betriebssystemupgrades ausgelöst werden, und dann auf Ereignisse pro VM reagieren (genehmigen, ablehnen oder verzögern), bevor die Plattform fortgesetzt wird.

Beispiele

Beispiel 1: Erstellen eines Lebenszyklus-Hooks für die Planung des automatischen Betriebssystemupgrades

$hook = New-AzVmssLifecycleHookConfig -Type 'UpgradeAutoOSScheduling' -WaitDuration 'PT8H'

In diesem Beispiel wird ein Lebenszyklus-Hook erstellt, der vor der Planung des automatischen Betriebssystemupgrades mit einer Wartezeit von 8 Stunden ausgelöst wird. Da -DefaultAction nicht angegeben ist, wendet der Dienst seine eigene Standardeinstellung an, wenn die Wartezeit abläuft.

Beispiel 2: Erstellen eines Lebenszyklus-Hooks mit expliziter Standardaktion

$hook = New-AzVmssLifecycleHookConfig -Type 'UpgradeAutoOSRollingBatchStarting' -WaitDuration 'PT30M' -DefaultAction 'Approve'

In diesem Beispiel wird ein Lebenszyklus-Hook erstellt, der ausgelöst wird, bevor jeder Rollbatch beginnt, mit einer Wartezeit von 30 Minuten und einer expliziten Standardaktion der Genehmigung.

Beispiel 3: Verwenden des Hooks in einem neuen VMSS

$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 diesem Beispiel wird ein VMSS mit einem angefügten Lebenszyklus-Hook erstellt.

Parameter

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Cf

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DefaultAction

Gibt die Aktion an, die auf eine Zielressource im Lebenszyklus-Hook-Ereignis angewendet wird, wenn die Plattform keine Antwort vom Kunden empfängt, bevor die Wartezeit abläuft. Akzeptierte Werte: "Genehmigen", "Ablehnen". Wenn sie weggelassen wird, wendet der Dienst seinen eigenen Standardwert an.

Parametereigenschaften

Typ:String
Standardwert:None
Zulässige Werte:Approve, Reject
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:2
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Type

Spezifiziert den Typ des Lebenszyklus-Hooks. Mögliche Werte: 'UpgradeAutoOSScheduling', 'UpgradeAutoOSRollingBatchStarting'.

Parametereigenschaften

Typ:String
Standardwert:None
Zulässige Werte:UpgradeAutoOSScheduling, UpgradeAutoOSRollingBatchStarting
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:0
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-WaitDuration

Gibt die Zeitdauer an, die das Lebenszyklus-Hook-Ereignis auf eine Kundenantwort wartet, bevor die Standardaktion angewendet wird. Muss im ISO 8601-Dauerformat vorliegen, z. B. "PT8H" (8 Stunden) oder "PT30M" (30 Minuten).

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:1
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

String

Ausgaben

LifecycleHook