Set-AzVmssLifecycleHooksProfile
Collega gli hook del ciclo di vita a una configurazione del set di scalabilità di macchine virtuali (VMSS) o a un oggetto VMSS attivo.
Sintassi
Default (Impostazione predefinita)
Set-AzVmssLifecycleHooksProfile
-VirtualMachineScaleSet <PSVirtualMachineScaleSet>
-LifecycleHook <LifecycleHook[]>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Il cmdlet Set-AzVmssLifecycleHooksProfile collega gli hook del ciclo di vita a un oggetto di configurazione VMSS (PSVirtualMachineScaleSet) e restituisce l'oggetto aggiornato. Segue la convenzione standard del generatore Az.Compute (uguale a Set-AzVmssOsProfile, Set-AzVmssStorageProfile): modifica l'oggetto config VMSS E lo restituisce.
L'oggetto aggiornato deve essere passato a New-AzVmss (per i nuovi set di scalabilità) o Update-AzVmss (per i set di scalabilità esistenti) per rendere persistenti le modifiche apportate a Azure.
Esempio
Esempio 1: Collegare un hook del ciclo di vita a una nuova configurazione del set di scalabilità di macchine virtuali
$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
Questo esempio crea un nuovo set di scalabilità di macchine virtuali con un hook del ciclo di vita collegato.
Esempio 2: Aggiungere un hook del ciclo di vita a un set di scalabilità di macchine virtuali esistente
$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
Questo esempio aggiunge un secondo hook del ciclo di vita a un set di scalabilità di macchine virtuali esistente, mantenendo gli hook esistenti.
Esempio 3: Usare la pipeline per collegare hook
$hook = New-AzVmssLifecycleHookConfig -Type 'UpgradeAutoOSScheduling' -WaitDuration 'PT8H'
New-AzVmssConfig -Location 'eastus' -SkuCapacity 2 | Set-AzVmssLifecycleHooksProfile -LifecycleHook $hook
Questo esempio usa la pipeline per collegare un hook del ciclo di vita a una configurazione del set di scalabilità di macchine virtuali.
Parametri
-Confirm
Richiede conferma prima di eseguire il cmdlet.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | cfr |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-DefaultProfile
Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.
Proprietà dei parametri
| Tipo: | IAzureContextContainer |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | AzContext, AzureRmContext, AzureCredential |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-LifecycleHook
Uno o più oggetti hook del ciclo di vita da collegare al set di scalabilità di macchine virtuali. Usare "New-AzVmssLifecycleHookConfig" per creare oggetti hook. Sostituisce tutti gli hook del ciclo di vita esistenti nell'oggetto config vmSS.
Proprietà dei parametri
| Tipo: | |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 1 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-VirtualMachineScaleSet
Oggetto di configurazione VMSS (PSVirtualMachineScaleSet) da aggiornare. Può essere una configurazione in memoria da 'New-AzVmssConfig' o un oggetto VMSS attivo da 'Get-AzVmss'.
Proprietà dei parametri
| Tipo: | PSVirtualMachineScaleSet |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Wi |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
