Update-AzVM

Sintassi

ResourceGroupNameParameterSetName (Impostazione predefinita)

Update-AzVM
    [-ResourceGroupName] <String>
    -VM <PSVirtualMachine>
    [-Tag <Hashtable>]
    [-OsDiskWriteAccelerator <Boolean>]
    [-UltraSSDEnabled <Boolean>]
    [-MaxPrice <Double>]
    [-EncryptionAtHost <Boolean>]
    [-ProximityPlacementGroupId <String>]
    [-VirtualMachineScaleSetId <String>]
    [-HostId <String>]
    [-CapacityReservationGroupId <String>]
    [-AsJob]
    [-NoWait]
    [-UserData <String>]
    [-HibernationEnabled]
    [-vCPUCountAvailable <Int32>]
    [-vCPUCountPerCore <Int32>]
    [-ProcessorMode <String>]
    [-SecurityType <String>]
    [-EnableVtpm <Boolean>]
    [-EnableSecureBoot <Boolean>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-AlignRegionalDisksToVMZone <Boolean>]
    [-ScheduledEventsApiVersion <String>]
    [-EnableAllInstancesDown <Boolean>]
    [-DisableCapacityReservationAssignment]
    [-PreferredVMSize <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ExplicitIdentityParameterSet

Update-AzVM
    [-ResourceGroupName] <String>
    -VM <PSVirtualMachine>
    -IdentityType <ResourceIdentityType>
    [-Tag <Hashtable>]
    [-IdentityId <String[]>]
    [-OsDiskWriteAccelerator <Boolean>]
    [-UltraSSDEnabled <Boolean>]
    [-MaxPrice <Double>]
    [-EncryptionAtHost <Boolean>]
    [-ProximityPlacementGroupId <String>]
    [-VirtualMachineScaleSetId <String>]
    [-HostId <String>]
    [-CapacityReservationGroupId <String>]
    [-AsJob]
    [-NoWait]
    [-UserData <String>]
    [-HibernationEnabled]
    [-vCPUCountAvailable <Int32>]
    [-vCPUCountPerCore <Int32>]
    [-ProcessorMode <String>]
    [-SecurityType <String>]
    [-EnableVtpm <Boolean>]
    [-EnableSecureBoot <Boolean>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-AlignRegionalDisksToVMZone <Boolean>]
    [-ScheduledEventsApiVersion <String>]
    [-EnableAllInstancesDown <Boolean>]
    [-DisableCapacityReservationAssignment]
    [-PreferredVMSize <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

IdParameterSetName

Update-AzVM
    [-Id] <String>
    -VM <PSVirtualMachine>
    [-Tag <Hashtable>]
    [-OsDiskWriteAccelerator <Boolean>]
    [-UltraSSDEnabled <Boolean>]
    [-MaxPrice <Double>]
    [-EncryptionAtHost <Boolean>]
    [-ProximityPlacementGroupId <String>]
    [-VirtualMachineScaleSetId <String>]
    [-HostId <String>]
    [-CapacityReservationGroupId <String>]
    [-AsJob]
    [-NoWait]
    [-UserData <String>]
    [-HibernationEnabled]
    [-vCPUCountAvailable <Int32>]
    [-vCPUCountPerCore <Int32>]
    [-ProcessorMode <String>]
    [-SecurityType <String>]
    [-EnableVtpm <Boolean>]
    [-EnableSecureBoot <Boolean>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-AlignRegionalDisksToVMZone <Boolean>]
    [-ScheduledEventsApiVersion <String>]
    [-EnableAllInstancesDown <Boolean>]
    [-DisableCapacityReservationAssignment]
    [-PreferredVMSize <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Descrizione

Esempio

Esempio 1: Aggiornare una macchina virtuale

Update-AzVM -ResourceGroupName "ResourceGroup11" -VM $VirtualMachine

Esempio 2: aggiornare una macchina virtuale per disabilitare l'hyperthreading.

$resourceGroupName = 'Resource Group Name>'
$vmname = 'Virtual Machine Name';
$domainNameLabel = "d1" + $rgname;
$vCPUsCoreInitial = 2;
$vCPUsAvailableInitial = 4;
$vCPUsCore1 = 1;
$vCPUsAvailable1 = 1;
$vmSize = 'Standard_D4s_v4';

$securePassword = ConvertTo-SecureString -String "****" -AsPlainText -Force;
$user = "user";
$cred = New-Object System.Management.Automation.PSCredential ($user, $securePassword);
$vm = New-AzVM -ResourceGroupName $rgname -Name $vmname -Credential $cred -DomainNameLabel $domainNameLabel -Size $vmSize -vCPUCountPerCore $vCPUsCoreInitial -vCPUCountAvailable $vCPUsAvailableInitial;
# The $vm.HardwareProfile.VmSizeProperties.VCPUsPerCore property is 2, and the $vm.HardwareProfile.VmSizeProperties.VCPUsAvailable property is 4.

Update-AzVM -ResourceGroupName $rgname -VM $vm -vCPUCountAvailable $vCPUsAvailable1 -vCPUCountPerCore $vCPUsCore1;
# The $vm.HardwareProfile.VmSizeProperties.VCPUsPerCore property is 1, and the $vm.HardwareProfile.VmSizeProperties.VCPUsAvailable property is 1.
# Hyperthreading is now disabled for this VM.

Esempio 3: Aggiornare una modalità processore di macchina virtuale

$vm = Get-AzVM -ResourceGroupName "myResourceGroup" -Name "myVM"
Update-AzVM -ResourceGroupName "myResourceGroup" -VM $vm -ProcessorMode "Opportunistic"

Esempio 4: Rifiutare esplicitamente una macchina virtuale dalla prenotazione della capacità

$vm = Get-AzVM -ResourceGroupName "myRG" -Name "myVM";
Update-AzVM -ResourceGroupName "myRG" -VM $vm -DisableCapacityReservationAssignment;

Esempio 5: Aggiornare una macchina virtuale per usare una dimensione preferita

$vm = Get-AzVM -ResourceGroupName "myRG" -Name "myVM"
Update-AzVM -ResourceGroupName "myRG" -VM $vm -PreferredVMSize "Standard_D4s_v5"

Esempio 6: Passare a FlexProfile modificando l'oggetto VM

$vm = Get-AzVM -ResourceGroupName "myRG" -Name "myVM"
$vm.FlexProfile = [Microsoft.Azure.Management.Compute.Models.FlexProfile]::new("Standard_D4s_v5")
$vm.HardwareProfile.VmSize = $null
Update-AzVM -ResourceGroupName "myRG" -VM $vm

Esempio 7: Mantenere FlexProfile in un round trip get-to-update

$vm = Get-AzVM -ResourceGroupName "myRG" -Name "myFlexVM"
$vm.Tags = @{ workload = "batch" }
Update-AzVM -ResourceGroupName "myRG" -VM $vm

Esempio 8: Rifiutare esplicitamente FlexProfile e usare una dimensione fissa

$vm = Get-AzVM -ResourceGroupName "myRG" -Name "myFlexVM"
$vm.FlexProfile = $null
$vm.HardwareProfile.VmSize = "Standard_D4s_v5"
Update-AzVM -ResourceGroupName "myRG" -VM $vm

Parametri

-AlignRegionalDisksToVMZone

Specifica se i dischi a livello di area devono essere allineati/spostati nella zona della macchina virtuale. Questo è applicabile solo per le macchine virtuali con set di proprietà di posizionamento. Si noti che questa modifica è irreversibile.

Proprietà dei parametri

Set di parametri

-AsJob

Eseguire il cmdlet in background e restituire un processo per tenere traccia dello stato di avanzamento.

Proprietà dei parametri

Set di parametri

-CapacityReservationGroupId

ID del gruppo di prenotazioni di capacità utilizzato per allocare.

Proprietà dei parametri

Set di parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Set di parametri

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Proprietà dei parametri

Set di parametri

-DisableCapacityReservationAssignment

Specifica che la macchina virtuale viene esplicitamente disattivata da qualsiasi assegnazione di prenotazione della capacità. Se impostata, la macchina virtuale non verrà associata in modo implicito o esplicito a una prenotazione di capacità e utilizzerà invece la capacità disponibile pubblicamente.

Proprietà dei parametri

Set di parametri

-EnableAllInstancesDown

Specifica se gli eventi pianificati devono essere approvati automaticamente quando tutte le istanze sono inattive.

Proprietà dei parametri

Set di parametri

-EnableSecureBoot

Specifica se l'avvio protetto deve essere abilitato nella macchina virtuale.

Proprietà dei parametri

Set di parametri

-EnableVtpm

Specifica se vTPM deve essere abilitato nella macchina virtuale.

Proprietà dei parametri

Set di parametri

-EncryptionAtHost

La proprietà EncryptionAtHost può essere usata dall'utente nella richiesta per abilitare o disabilitare la crittografia host per la macchina virtuale o il set di scalabilità di macchine virtuali. In questo modo verrà abilitata la crittografia per tutti i dischi, incluso il disco Resource/Temp nell'host stesso.

Proprietà dei parametri

Set di parametri

-HibernationEnabled

Flag che abilita o disabilita la funzionalità di ibernazione nella macchina virtuale.

Proprietà dei parametri

Set di parametri

-HostId

ID dell'host

Proprietà dei parametri

Set di parametri

-Id

Specifica l'ID risorsa della macchina virtuale.

Proprietà dei parametri

Set di parametri

-IdentityId

Specifica l'elenco delle identità utente associate alla macchina virtuale. I riferimenti all'identità utente saranno ID risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. ManagedIdentity/identities/{identityName}'

Proprietà dei parametri

Set di parametri

-IdentityType

Tipo di identità usata per la macchina virtuale. I valori validi sono SystemAssigned, UserAssigned, SystemAssignedUserAssigned e None.

Proprietà dei parametri

Set di parametri

-IfMatch

utilizzato per rendere condizionale una richiesta per PUT e altri metodi non sicuri. Il server restituirà le risorse richieste solo se la risorsa corrisponde a uno dei valori ETag elencati. Omettere questo valore per sovrascrivere sempre la risorsa corrente. Specificare l'ultimo valore ETag visualizzato per impedire la sovrascrittura accidentale delle modifiche simultanee.

Proprietà dei parametri

Set di parametri

-IfNoneMatch

Usato per rendere condizionale una richiesta per i metodi GET e HEAD. Il server restituirà le risorse richieste solo se nessuno dei valori ETag elencati corrisponde all'entità corrente. Usato per rendere condizionale una richiesta per i metodi GET e HEAD. Il server restituirà le risorse richieste solo se nessuno dei valori ETag elencati corrisponde all'entità corrente. Impostare su '*' per consentire la creazione di un nuovo set di record, ma per impedire l'aggiornamento di un set di record esistente. Gli altri valori genereranno errori dal server perché non sono supportati.

Proprietà dei parametri

Set di parametri

-MaxPrice

Specifica il prezzo massimo che si vuole pagare per una macchina virtuale/set di scalabilità di macchine virtuali con priorità bassa. Questo prezzo è in dollari USA. Questo prezzo verrà confrontato con il prezzo di priorità bassa corrente per le dimensioni della macchina virtuale. Inoltre, i prezzi vengono confrontati al momento della creazione/aggiornamento di macchine virtuali/set di scalabilità di macchine virtuali con priorità bassa e l'operazione avrà esito positivo solo se il prezzo maxPrice è maggiore del prezzo di priorità bassa corrente. MaxPrice verrà usato anche per rimuovere una macchina virtuale/set di scalabilità di macchine virtuali con priorità bassa se il prezzo di priorità bassa corrente supera il valore maxPrice dopo la creazione di macchine virtuali/set di scalabilità di macchine virtuali. I valori possibili sono: qualsiasi valore decimale maggiore di zero. Esempio: 0.01538. -1 indica che la macchina virtuale/set di scalabilità di macchine virtuali con priorità bassa non deve essere rimossa per motivi di prezzo. Inoltre, il prezzo massimo predefinito è -1 se non è fornito dall'utente.

Proprietà dei parametri

Set di parametri

-NoWait

Avvia l'operazione e restituisce immediatamente, prima del completamento dell'operazione. Per determinare se l'operazione è stata completata correttamente, usare un altro meccanismo.

Proprietà dei parametri

Set di parametri

-OsDiskWriteAccelerator

Specifica se WriteAccelerator deve essere abilitato o disabilitato nel disco del sistema operativo.

Proprietà dei parametri

Set di parametri

-PreferredVMSize

Specifica le dimensioni della macchina virtuale preferite per l'anteprima FlexProfile, ad esempio Standard_D4s_v5. Azure possibile scegliere un'alternativa compatibile in base alla capacità e al posizionamento. In tutti i set di parametri questo parametro esegue l'override della HardwareProfile.VmSize richiesta in uscita e imposta FlexProfile.PreferredVMSize senza modificare il profilo hardware dell'oggetto di input o FlexProfile. Se omesso, sia l'input FlexProfile che VmSize vengono mantenuti nella richiesta, incluse le dimensioni segnalate dal servizio di una macchina virtuale FlexProfile esistente. Per passare direttamente modificando l'oggetto, impostare FlexProfile e deselezionare VmSize. Per rifiutare esplicitamente, deselezionare FlexProfile, impostare una vmSize fissa e omettere questo parametro. Questa funzionalità richiede la registrazione in anteprima e la disponibilità a livello di area. Azure convalida il posizionamento e le stringhe vuote non supportate.

Proprietà dei parametri

Set di parametri

-ProcessorMode

Specifica il comportamento della frequenza del processore. I valori tipici sono Deterministic e Opportunistic.

Proprietà dei parametri

Set di parametri

-ProximityPlacementGroupId

ID risorsa del gruppo di posizionamento di prossimità da usare con questa macchina virtuale.

Proprietà dei parametri

Set di parametri

-ResourceGroupName

Specifica il nome del gruppo di risorse della macchina virtuale.

Proprietà dei parametri

Set di parametri

-ScheduledEventsApiVersion

Specifica la versione dell'API per determinare quale versione dello schema di configurazione degli eventi pianificati verrà recapitata. Formato: AAAA-MM-GG. Per le versioni api disponibili, vedere https://learn.microsoft.com/rest/api/compute/scheduled-events.

Proprietà dei parametri

Set di parametri

-SecurityType

Specifica il Tipo di sicurezza della macchina virtuale. Deve essere impostato su qualsiasi valore specificato per abilitare UefiSettings. Per impostazione predefinita, UefiSettings non verrà abilitato a meno che questa proprietà non sia impostata.

Proprietà dei parametri

Set di parametri

-Tag

Specifica che le risorse e i gruppi di risorse possono essere contrassegnati con un set di coppie nome-valore. L'aggiunta di tag alle risorse consente di raggruppare le risorse tra gruppi di risorse e di creare visualizzazioni personalizzate. Ogni risorsa o gruppo di risorse può avere un massimo di 15 tag.

Proprietà dei parametri

Set di parametri

-UltraSSDEnabled

Flag che abilita o disabilita una funzionalità per avere uno o più dischi dati gestiti con UltraSSD_LRS tipo di account di archiviazione nella macchina virtuale. I dischi gestiti con tipo di account di archiviazione UltraSSD_LRS possono essere aggiunti a una macchina virtuale solo se questa proprietà è abilitata.

Proprietà dei parametri

Set di parametri

-UserData

UserData per la macchina virtuale, che verrà codificata in base 64. Il cliente non deve passare segreti qui.

Proprietà dei parametri

Set di parametri

-vCPUCountAvailable

Specifica il numero di vCPU disponibili per la macchina virtuale. Quando questa proprietà non viene specificata nel corpo della richiesta, il comportamento predefinito consiste nell'impostarlo sul valore delle vCPU disponibili per le dimensioni della macchina virtuale esposte nella risposta api di Elencare tutte le dimensioni delle macchine virtuali disponibili in un'area.

Proprietà dei parametri

Set di parametri

-vCPUCountPerCore

Specifica il rapporto tra vCPU e core fisici. Quando questa proprietà non viene specificata nel corpo della richiesta, il comportamento predefinito è impostato sul valore di vCPUsPerCore per le dimensioni della macchina virtuale esposte in risposta api di Elenca tutte le dimensioni delle macchine virtuali disponibili in un'area. L'impostazione di questa proprietà su 1 significa anche che l'hyper-threading è disabilitato.

Proprietà dei parametri

Set di parametri

-VirtualMachineScaleSetId

ID per il set di scalabilità di macchine virtuali a cui deve essere aggiornata la macchina virtuale.

Proprietà dei parametri

Set di parametri

-VM

Specifica un oggetto macchina virtuale locale. Per ottenere un oggetto macchina virtuale, usare il cmdlet Get-AzVM . Questo oggetto macchina virtuale contiene lo stato aggiornato per la macchina virtuale.

Proprietà dei parametri

Set di parametri

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Proprietà dei parametri

Set di parametri

CommonParameters

Input

String

PSVirtualMachine

Boolean

Output

PSAzureOperationResponse

Collegamenti correlati

• Get-AzVM
• New-AzVM
• Remove-AzVM
• Restart-AzVM
• Start-AzVM
• Stop-AzVM
• New-AzVMConfig