Update-AzureRmVmss
Aggiornamenti lo stato di un set di scalabilità di macchine virtuali.
Avviso
Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.
Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.
Sintassi
Update-AzureRmVmss
[-ResourceGroupName] <String>
[-VMScaleSetName] <String>
[[-VirtualMachineScaleSet] <PSVirtualMachineScaleSet>]
[-ImageReferenceSku <String>]
[-ManagedDiskStorageAccountType <String>]
[-PlanPublisher <String>]
[-ProvisionVMAgent <Boolean>]
[-BootDiagnosticsEnabled <Boolean>]
[-Overprovision <Boolean>]
[-MaxBatchInstancePercent <Int32>]
[-TimeZone <String>]
[-BootDiagnosticsStorageUri <String>]
[-AutomaticOSUpgrade <Boolean>]
[-DisableAutoRollback <Boolean>]
[-SinglePlacementGroup <Boolean>]
[-CustomData <String>]
[-UpgradePolicyMode <UpgradeMode>]
[-ImageReferenceId <String>]
[-DisablePasswordAuthentication <Boolean>]
[-Tag <Hashtable>]
[-PlanName <String>]
[-MaxUnhealthyUpgradedInstancePercent <Int32>]
[-ImageReferencePublisher <String>]
[-PlanProduct <String>]
[-VhdContainer <String[]>]
[-ImageUri <String>]
[-SkuTier <String>]
[-EnableAutomaticUpdate <Boolean>]
[-LicenseType <String>]
[-SkuName <String>]
[-PlanPromotionCode <String>]
[-MaxUnhealthyInstancePercent <Int32>]
[-SkuCapacity <Int32>]
[-OsDiskWriteAccelerator <Boolean>]
[-ImageReferenceOffer <String>]
[-PauseTimeBetweenBatches <String>]
[-OsDiskCaching <CachingTypes>]
[-ImageReferenceVersion <String>]
[-UltraSSDEnabled <Boolean>]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Update-AzureRmVmss
[-ResourceGroupName] <String>
[-VMScaleSetName] <String>
[[-VirtualMachineScaleSet] <PSVirtualMachineScaleSet>]
[-ImageReferenceSku <String>]
[-IdentityId <String[]>]
[-ManagedDiskStorageAccountType <String>]
[-PlanPublisher <String>]
[-ProvisionVMAgent <Boolean>]
[-BootDiagnosticsEnabled <Boolean>]
[-Overprovision <Boolean>]
[-MaxBatchInstancePercent <Int32>]
[-TimeZone <String>]
[-BootDiagnosticsStorageUri <String>]
[-AutomaticOSUpgrade <Boolean>]
[-DisableAutoRollback <Boolean>]
[-SinglePlacementGroup <Boolean>]
[-CustomData <String>]
[-UpgradePolicyMode <UpgradeMode>]
[-ImageReferenceId <String>]
[-DisablePasswordAuthentication <Boolean>]
[-Tag <Hashtable>]
[-PlanName <String>]
[-MaxUnhealthyUpgradedInstancePercent <Int32>]
[-ImageReferencePublisher <String>]
[-PlanProduct <String>]
[-VhdContainer <String[]>]
[-ImageUri <String>]
[-SkuTier <String>]
[-EnableAutomaticUpdate <Boolean>]
[-LicenseType <String>]
-IdentityType <ResourceIdentityType>
[-SkuName <String>]
[-PlanPromotionCode <String>]
[-MaxUnhealthyInstancePercent <Int32>]
[-SkuCapacity <Int32>]
[-OsDiskWriteAccelerator <Boolean>]
[-ImageReferenceOffer <String>]
[-PauseTimeBetweenBatches <String>]
[-OsDiskCaching <CachingTypes>]
[-ImageReferenceVersion <String>]
[-UltraSSDEnabled <Boolean>]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Il cmdlet Update-AzureRmVmss aggiorna lo stato di un set di scalabilità di macchine virtuali (VMSS) allo stato di un oggetto VMSS locale.
Esempio
Esempio 1: aggiornare lo stato di un set di scalabilità di macchine virtuali allo stato di un oggetto VMSS locale.
PS C:\> Update-AzureRmVmss -ResourceGroupName "Group001" -Name "VMSS001" -VirtualMachineScaleSet $LocalVMSS
Questo comando aggiorna lo stato del set di scalabilità di macchine virtuali denominato VMSS001 che appartiene al gruppo di risorse denominato Group001 allo stato di un oggetto VMSS locale, $LocalVMSS.
Parametri
-AsJob
Eseguire il cmdlet in background e restituire un processo per tenere traccia dello stato di avanzamento.
Tipo: | SwitchParameter |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-AutomaticOSUpgrade
Imposta se gli aggiornamenti del sistema operativo devono essere applicati automaticamente alle istanze del set di scalabilità in sequenza quando diventa disponibile una versione più recente dell'immagine.
Tipo: | Boolean |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-BootDiagnosticsEnabled
Indica se la diagnostica di avvio deve essere abilitata nel set di scalabilità di macchine virtuali.
Tipo: | Boolean |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-BootDiagnosticsStorageUri
URI dell'account di archiviazione da usare per inserire l'output e lo screenshot della console.
Tipo: | String |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-Confirm
Richiede conferma prima di eseguire il cmdlet.
Tipo: | SwitchParameter |
Alias: | cf |
Posizione: | Named |
Valore predefinito: | False |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-CustomData
Specifica una stringa con codifica base 64 di dati personalizzati. Questa operazione viene decodificata in una matrice binaria salvata come file nella macchina virtuale. La lunghezza massima della matrice binaria è di 65535 byte.
Tipo: | String |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-DefaultProfile
Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.
Tipo: | IAzureContextContainer |
Alias: | AzureRmContext, AzureCredential |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-DisableAutoRollback
Disabilitare il rollback automatico per i criteri di aggiornamento automatico del sistema operativo
Tipo: | Boolean |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-DisablePasswordAuthentication
Indica che questo cmdlet disabilita l'autenticazione della password per il sistema operativo Linux.
Tipo: | Boolean |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-EnableAutomaticUpdate
Indica se le macchine virtuali Windows nel set di scalabilità di macchine virtuali sono abilitate per gli aggiornamenti automatici.
Tipo: | Boolean |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-IdentityId
Specifica l'elenco delle identità utente associate al set di scalabilità di macchine virtuali. I riferimenti all'identità utente saranno id risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identities/{identityName}'
Tipo: | String[] |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-IdentityType
Specifica il tipo di identità usato per il set di scalabilità di macchine virtuali. Il tipo 'SystemAssignedUserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo "Nessuno" rimuoverà tutte le identità dal set di scalabilità di macchine virtuali. I valori validi per questo parametro sono:
- SystemAssigned
- UserAssigned
- SystemAssignedUserAssigned
- None
Tipo: | Nullable<T>[ResourceIdentityType] |
Valori accettati: | SystemAssigned, UserAssigned, SystemAssignedUserAssigned, None |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-ImageReferenceId
Specifica l'ID di riferimento dell'immagine.
Tipo: | String |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-ImageReferenceOffer
Specifica il tipo di offerta di immagine della macchina virtuale (VMImage). Per ottenere un'offerta di immagine, usare il cmdlet Get-AzureRmVMImageOffer.
Tipo: | String |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-ImageReferencePublisher
Specifica il nome di un server di pubblicazione di vmImage. Per ottenere un server di pubblicazione, usare il cmdlet Get-AzureRmVMImagePublisher.
Tipo: | String |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-ImageReferenceSku
Specifica lo SKU VMImage. Per ottenere gli SKU, usare il cmdlet Get-AzureRmVMImageSku.
Tipo: | String |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-ImageReferenceVersion
Specifica la versione di VMImage. Per usare la versione più recente, specificare il valore più recente anziché una versione specifica.
Tipo: | String |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-ImageUri
Specifica l'URI BLOB per l'immagine utente. VMSS crea un disco del sistema operativo nello stesso contenitore dell'immagine utente.
Tipo: | String |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-LicenseType
Specificare il tipo di licenza, che consiste nel portare uno scenario di licenza personalizzato.
Tipo: | String |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-ManagedDiskStorageAccountType
Specifica il tipo di account di archiviazione per il disco gestito. I valori validi per questo parametro sono:
- StandardLRS
- PremiumLRS
Tipo: | String |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-MaxBatchInstancePercent
Percentuale massima delle istanze totali di macchine virtuali che verranno aggiornate contemporaneamente dall'aggiornamento in sequenza in un unico batch. Poiché si tratta di un valore massimo, le istanze non integre nei batch precedenti o futuri possono causare la diminuzione della percentuale di istanze in un batch per garantire una maggiore affidabilità. Se il valore non viene specificato, viene impostato su 20.
Tipo: | Int32 |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-MaxUnhealthyInstancePercent
Percentuale massima delle istanze totali della macchina virtuale nel set di scalabilità che possono essere contemporaneamente non integre, in seguito all'aggiornamento o rilevate in uno stato non integro dai controlli di integrità della macchina virtuale prima dell'interruzione dell'aggiornamento in sequenza. Questo vincolo verrà controllato prima di avviare qualsiasi batch. Se il valore non viene specificato, viene impostato su 20.
Tipo: | Int32 |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-MaxUnhealthyUpgradedInstancePercent
Percentuale massima di istanze di macchina virtuale aggiornate che possono essere trovate in uno stato non integro. Questo controllo verrà eseguito dopo l'aggiornamento di ogni batch. Se questa percentuale viene mai superata, l'aggiornamento in sequenza viene interrotto. Se il valore non viene specificato, viene impostato su 20.
Tipo: | Int32 |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-OsDiskCaching
Specifica la modalità di memorizzazione nella cache del disco del sistema operativo. I valori validi per questo parametro sono:
- None
- ReadOnly
- ReadWrite Il valore predefinito è ReadWrite. Se si modifica il valore di memorizzazione nella cache, il cmdlet riavvia la macchina virtuale. Questa impostazione influisce sulla coerenza e sulle prestazioni del disco.
Tipo: | CachingTypes |
Valori accettati: | None, ReadOnly, ReadWrite |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-OsDiskWriteAccelerator
Specifica se WriteAccelerator deve essere abilitato o disabilitato nel disco del sistema operativo.
Tipo: | Boolean |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-Overprovision
Indica se il cmdlet esegue il provisioning eccessivo del set di scalabilità di macchine virtuali.
Tipo: | Boolean |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-PauseTimeBetweenBatches
Tempo di attesa tra il completamento dell'aggiornamento per tutte le macchine virtuali in un batch e l'avvio del batch successivo. La durata dell'ora deve essere specificata nel formato ISO 8601. Il valore predefinito è 0 secondi (PT0S).
Tipo: | String |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-PlanName
Specifica il nome del piano.
Tipo: | String |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-PlanProduct
Specifica il prodotto del piano.
Tipo: | String |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-PlanPromotionCode
Specifica il codice promozionale del piano.
Tipo: | String |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-PlanPublisher
Specifica l'editore del piano.
Tipo: | String |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-ProvisionVMAgent
Indica se è necessario eseguire il provisioning dell'agente di macchine virtuali nelle macchine virtuali Windows nel set di scalabilità di macchine virtuali.
Tipo: | Boolean |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-ResourceGroupName
Specifica il nome del gruppo di risorse a cui appartiene il set di scalabilità di macchine virtuali.
Tipo: | String |
Posizione: | 1 |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-SinglePlacementGroup
Specifica il singolo gruppo di posizionamento.
Tipo: | Boolean |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-SkuCapacity
Specifica il numero di istanze nel set di scalabilità di macchine virtuali.
Tipo: | Int32 |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-SkuName
Specifica le dimensioni di tutte le istanze del set di scalabilità di macchine virtuali.
Tipo: | String |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-SkuTier
Specifica il livello del set di scalabilità di macchine virtuali. I valori validi per questo parametro sono:
- Standard
- Di base
Tipo: | String |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-Tag
Coppie chiave-valore sotto forma di tabella hash. Ad esempio: @{key0="value0"; key1=$null; key2="value2"}
Tipo: | Hashtable |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-TimeZone
Specifica il fuso orario per il sistema operativo Windows.
Tipo: | String |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-UltraSSDEnabled
Flag che abilita o disabilita una funzionalità per avere uno o più dischi dati gestiti con UltraSSD_LRS tipo di account di archiviazione nel set di scalabilità di macchine virtuali. I dischi gestiti con tipo di account di archiviazione UltraSSD_LRS possono essere aggiunti a un set di scalabilità di macchine virtuali solo se questa proprietà è abilitata.
Tipo: | Boolean |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-UpgradePolicyMode
Specifica la modalità di un aggiornamento alle macchine virtuali nel set di scalabilità. I valori validi per questo parametro sono:
- Automatico
- Manuale
- Rolling
Tipo: | UpgradeMode |
Valori accettati: | Automatic, Manual, Rolling |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-VhdContainer
Specifica gli URL del contenitore usati per archiviare i dischi del sistema operativo per il set di scalabilità di macchine virtuali.
Tipo: | String[] |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-VirtualMachineScaleSet
Specifica un oggetto VMSS locale. Per ottenere un oggetto VMSS, usare il cmdlet Get-AzureRmVmss. Questo oggetto macchina virtuale contiene lo stato aggiornato per il set di scalabilità di macchine virtuali.
Tipo: | PSVirtualMachineScaleSet |
Posizione: | 3 |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-VMScaleSetName
Specifica il nome del set di scalabilità di macchine virtuali creato da questo cmdlet.
Tipo: | String |
Alias: | Name |
Posizione: | 2 |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.
Tipo: | SwitchParameter |
Alias: | wi |
Posizione: | Named |
Valore predefinito: | False |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
Input
Parametri: VirtualMachineScaleSet (ByValue)