Update-AzVM

Referentie

Module:: Az.Compute

Hiermee werkt u de status van een virtuele Azure-machine bij.

Syntax

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>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzVM
      [-ResourceGroupName] <String>
      -VM <PSVirtualMachine>
      [-Tag <Hashtable>]
      -IdentityType <ResourceIdentityType>
      [-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>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

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>]
      [-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 = 'Password' | ConvertTo-SecureString -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

-AsJob

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CapacityReservationGroupId

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableSecureBoot

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

Type:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-EnableVtpm

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

Type:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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.

Type:	Boolean
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HibernationEnabled

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-HostId

De id van host

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Id

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

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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}'

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IdentityType

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

Type:	Nullable<T>[ResourceIdentityType]
Accepted values:	SystemAssigned, UserAssigned, SystemAssignedUserAssigned, None
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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 standaard maximumprijs is -1 als deze niet door u wordt verstrekt.

Type:	Double
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OsDiskWriteAccelerator

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ProximityPlacementGroupId

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

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

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-SecurityType

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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 hebben.

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-UserData

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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, is het standaardgedrag om deze in te stellen 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.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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 de API-respons van alle beschikbare grootten van virtuele machines in een regio. Als u deze eigenschap instelt op 1, betekent dit ook dat hyperthreading is uitgeschakeld.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-VirtualMachineScaleSetId

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VM

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

Type:	PSVirtualMachine
Aliases:	VMProfile
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Invoerwaarden

String

PSVirtualMachine

Boolean

Uitvoerwaarden

PSAzureOperationResponse

Update-AzVM

Syntax

Description

Voorbeelden

Voorbeeld 1: Een virtuele machine bijwerken

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

Parameters

-AsJob

-CapacityReservationGroupId

-Confirm

-DefaultProfile

-EnableSecureBoot

-EnableVtpm

-EncryptionAtHost

-HibernationEnabled

-HostId

-Id

-IdentityId

-IdentityType

-MaxPrice

-NoWait

-OsDiskWriteAccelerator

-ProximityPlacementGroupId

-ResourceGroupName

-SecurityType

-Tag

-UltraSSDEnabled

-UserData

-vCPUCountAvailable

-vCPUCountPerCore

-VirtualMachineScaleSetId

-VM

-WhatIf

Invoerwaarden

Uitvoerwaarden

Feedback

Aanvullende resources

Update-AzVM

Syntax

Description

Voorbeelden

Voorbeeld 1: Een virtuele machine bijwerken

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

Parameters

-AsJob

-CapacityReservationGroupId

-Confirm

-DefaultProfile

-EnableSecureBoot

-EnableVtpm

-EncryptionAtHost

-HibernationEnabled

-HostId

-Id

-IdentityId

-IdentityType

-MaxPrice

-NoWait

-OsDiskWriteAccelerator

-ProximityPlacementGroupId

-ResourceGroupName

-SecurityType

-Tag

-UltraSSDEnabled

-UserData

-vCPUCountAvailable

-vCPUCountPerCore

-VirtualMachineScaleSetId

-VM

-WhatIf

Invoerwaarden

Uitvoerwaarden

Verwante koppelingen

Feedback

Aanvullende resources