Delen via


Update-AzVM

Hiermee wordt de status van een virtuele Azure-machine bijgewerkt.

Syntax

ResourceGroupNameParameterSetName (Standaard)

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>]
    [-SecurityType <String>]
    [-EnableVtpm <Boolean>]
    [-EnableSecureBoot <Boolean>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-AlignRegionalDisksToVMZone <Boolean>]
    [-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>]
    [-SecurityType <String>]
    [-EnableVtpm <Boolean>]
    [-EnableSecureBoot <Boolean>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-AlignRegionalDisksToVMZone <Boolean>]
    [-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>]
    [-SecurityType <String>]
    [-EnableVtpm <Boolean>]
    [-EnableSecureBoot <Boolean>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-AlignRegionalDisksToVMZone <Boolean>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

De cmdlet Update-AzVM werkt de status van een virtuele Azure-machine bij naar de status van een virtuele-machineobject.

Voorbeelden

Voorbeeld 1: Een virtuele machine bijwerken

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

Met deze opdracht wordt de virtuele machine, $VirtualMachine, bijgewerkt in ResourceGroup11. Met de opdracht wordt deze bijgewerkt met behulp van het object van de virtuele machine dat is opgeslagen in de $VirtualMachine variabele. Gebruik de cmdlet Get-AzVM om een virtuele-machineobject op te halen.

Voorbeeld 2: Een virtuele machine bijwerken om hyperthreading uit te schakelen.

$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.

Parameters

-AlignRegionalDisksToVMZone

Hiermee geeft u op of de regionale schijven moeten worden uitgelijnd/verplaatst naar de VM-zone. Dit is alleen van toepassing op VM's waarvoor plaatsingseigenschappen zijn ingesteld. Houd er rekening mee dat deze wijziging niet ongedaan kan worden.

Parametereigenschappen

Type:

Nullable<T>[Boolean]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-AsJob

Voer de cmdlet op de achtergrond uit en retourneer een taak om de voortgang bij te houden.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-CapacityReservationGroupId

Id van de capaciteitsreserveringsgroep die wordt gebruikt om toe te wijzen.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Cf

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Parametereigenschappen

Type:IAzureContextContainer
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AzContext, AzureRmContext, AzureCredential

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-EnableSecureBoot

Hiermee geeft u op of beveiligd opstarten moet worden ingeschakeld op de virtuele machine.

Parametereigenschappen

Type:

Nullable<T>[Boolean]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-EnableVtpm

Hiermee geeft u op of vTPM moet worden ingeschakeld op de virtuele machine.

Parametereigenschappen

Type:

Nullable<T>[Boolean]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-EncryptionAtHost

De eigenschap EncryptionAtHost kan worden gebruikt door de gebruiker in de aanvraag om hostversleuteling voor de virtuele machine of virtuele-machineschaalset in of uit te schakelen. Hierdoor wordt de versleuteling ingeschakeld voor alle schijven, inclusief resource-/tijdelijke schijf op de host zelf.

Parametereigenschappen

Type:Boolean
Default value:False
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-HibernationEnabled

De vlag waarmee de sluimerstand op de VIRTUELE machine wordt ingeschakeld of uitgeschakeld.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-HostId

De id van host

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Id

Hiermee geeft u de resource-id van de virtuele machine.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

IdParameterSetName
Position:0
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-IdentityId

Hiermee geeft u de lijst met gebruikersidentiteiten die aan de virtuele machine zijn gekoppeld. De verwijzingen naar gebruikersidentiteiten zijn ARM-resource-id's in de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identities/{identityName}'

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

ExplicitIdentityParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-IdentityType

Het type identiteit dat wordt gebruikt voor de virtuele machine. Geldige waarden zijn SystemAssigned, UserAssigned, SystemAssignedUserAssigned en None.

Parametereigenschappen

Type:

Nullable<T>[ResourceIdentityType]

Default value:None
Geaccepteerde waarden:SystemAssigned, UserAssigned, SystemAssignedUserAssigned, None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

ExplicitIdentityParameterSet
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-IfMatch

wordt gebruikt om een aanvraag voorwaardelijk te maken voor de PUT en andere niet-veilige methoden. De server retourneert alleen de aangevraagde resources als de resource overeenkomt met een van de vermelde ETag-waarden. Laat deze waarde weg om de huidige resource altijd te overschrijven. Geef de laatst geziene ETag-waarde op om te voorkomen dat gelijktijdige wijzigingen per ongeluk worden overschreven.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-IfNoneMatch

Wordt gebruikt om een aanvraag voorwaardelijk te maken voor de GET- en HEAD-methoden. De server retourneert alleen de aangevraagde resources als geen van de vermelde ETag-waarden overeenkomt met de huidige entiteit. Wordt gebruikt om een aanvraag voorwaardelijk te maken voor de GET- en HEAD-methoden. De server retourneert alleen de aangevraagde resources als geen van de vermelde ETag-waarden overeenkomt met de huidige entiteit. Stel deze optie in op *, zodat een nieuwe recordset kan worden gemaakt, maar om te voorkomen dat een bestaande recordset wordt bijgewerkt. Andere waarden resulteren in een fout van de server omdat ze niet worden ondersteund.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-MaxPrice

Hiermee geeft u de maximumprijs op die u wilt betalen voor een VM/VMSS met lage prioriteit. Deze prijs is in Amerikaanse dollars. Deze prijs wordt vergeleken met de huidige prijs met lage prioriteit voor de VM-grootte. De prijzen worden ook vergeleken op het moment van het maken/bijwerken van VM/VMSS met lage prioriteit en de bewerking slaagt alleen als de maxPrice groter is dan de huidige prijs met lage prioriteit. De maxPrice wordt ook gebruikt voor het verwijderen van een VM/VMSS met lage prioriteit als de huidige prijs met lage prioriteit hoger is dan de maxPrice na het maken van VM/VMSS. Mogelijke waarden zijn: elke decimale waarde groter dan nul. Voorbeeld: 0.01538. -1 geeft aan dat de VM/VMSS met lage prioriteit niet om prijsredenen mag worden verwijderd. De standaardprijs is ook -1 als deze niet door u wordt verstrekt.

Parametereigenschappen

Type:Double
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-NoWait

Start de bewerking en retourneert onmiddellijk voordat de bewerking is voltooid. Gebruik een ander mechanisme om te bepalen of de bewerking is voltooid.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-OsDiskWriteAccelerator

Hiermee geeft u op of WriteAccelerator moet worden ingeschakeld of uitgeschakeld op de besturingssysteemschijf.

Parametereigenschappen

Type:Boolean
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ProximityPlacementGroupId

De resource-id van de nabijheidsplaatsingsgroep die moet worden gebruikt met deze virtuele machine.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ResourceGroupName

Hiermee geeft u de naam van de resourcegroep van de virtuele machine.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

ResourceGroupNameParameterSetName
Position:0
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False
ExplicitIdentityParameterSet
Position:0
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-SecurityType

Hiermee geeft u het SecurityType van de virtuele machine. Deze moet worden ingesteld op een opgegeven waarde om UefiSettings in te schakelen. UefiSettings wordt standaard niet ingeschakeld, tenzij deze eigenschap is ingesteld.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Tag

Hiermee geeft u de resources en resourcegroepen kan worden getagd met een set naam-waardeparen. Door tags toe te voegen aan resources kunt u resources groeperen in resourcegroepen en uw eigen weergaven maken. Elke resource of resourcegroep kan maximaal 15 tags bevatten.

Parametereigenschappen

Type:Hashtable
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-UltraSSDEnabled

De vlag waarmee een mogelijkheid wordt ingeschakeld of uitgeschakeld voor een of meer beheerde gegevensschijven met UltraSSD_LRS opslagaccounttype op de virtuele machine. Beheerde schijven met het type opslagaccount UltraSSD_LRS kunnen alleen worden toegevoegd aan een virtuele machine als deze eigenschap is ingeschakeld.

Parametereigenschappen

Type:Boolean
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-UserData

UserData voor de VIRTUELE machine, die wordt gecodeerd met base-64. De klant mag hier geen geheimen doorgeven.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-vCPUCountAvailable

Hiermee geeft u het aantal vCPU's dat beschikbaar is voor de virtuele machine. Wanneer deze eigenschap niet is opgegeven in de aanvraagbody, wordt het standaardgedrag ingesteld op de waarde van vCPU's die beschikbaar zijn voor die VM-grootte die beschikbaar is in api-antwoord van Alle beschikbare grootten van virtuele machines in een regio weergeven.

Parametereigenschappen

Type:Int32
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-vCPUCountPerCore

Hiermee geeft u de verhouding tussen vCPU en fysieke kern. Wanneer deze eigenschap niet is opgegeven in de aanvraagbody, wordt het standaardgedrag ingesteld op de waarde van vCPUUsPerCore voor de VM-grootte die wordt weergegeven in api-antwoord van Alle beschikbare grootten van virtuele machines in een regio weergeven. Als u deze eigenschap instelt op 1, betekent dit ook dat hyperthreading is uitgeschakeld.

Parametereigenschappen

Type:Int32
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-VirtualMachineScaleSetId

Id voor de virtuele-machineschaalset waarnaar de virtuele machine moet worden bijgewerkt.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-VM

Hiermee geeft u een lokale virtuele-machineobject. Gebruik de cmdlet Get-AzVM om een object voor een virtuele machine te verkrijgen. Dit virtuele-machineobject bevat de bijgewerkte status voor de virtuele machine.

Parametereigenschappen

Type:PSVirtualMachine
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:VMProfile

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-WhatIf

Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Wi

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

String

PSVirtualMachine

Boolean

Uitvoerwaarden

PSAzureOperationResponse