Update-AzVM

Referentie

Module:: Az.Compute

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

Notitie

Dit is de vorige versie van onze documentatie. Raadpleeg de meest recente versie voor actuele informatie.

Syntax

Update-AzVM
      [-ResourceGroupName] <String>
      -VM <PSVirtualMachine>
      [-Tag <Hashtable>]
      [-OsDiskWriteAccelerator <Boolean>]
      [-UltraSSDEnabled <Boolean>]
      [-MaxPrice <Double>]
      [-EncryptionAtHost <Boolean>]
      [-ProximityPlacementGroupId <String>]
      [-HostId <String>]
      [-CapacityReservationGroupId <String>]
      [-AsJob]
      [-NoWait]
      [-UserData <String>]
      [-HibernationEnabled]
      [-vCPUCountAvailable <Int32>]
      [-vCPUCountPerCore <Int32>]
      [-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>]
      [-HostId <String>]
      [-CapacityReservationGroupId <String>]
      [-AsJob]
      [-NoWait]
      [-UserData <String>]
      [-HibernationEnabled]
      [-vCPUCountAvailable <Int32>]
      [-vCPUCountPerCore <Int32>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzVM
      [-Id] <String>
      -VM <PSVirtualMachine>
      [-Tag <Hashtable>]
      [-OsDiskWriteAccelerator <Boolean>]
      [-UltraSSDEnabled <Boolean>]
      [-MaxPrice <Double>]
      [-EncryptionAtHost <Boolean>]
      [-ProximityPlacementGroupId <String>]
      [-HostId <String>]
      [-CapacityReservationGroupId <String>]
      [-AsJob]
      [-NoWait]
      [-UserData <String>]
      [-HibernationEnabled]
      [-vCPUCountAvailable <Int32>]
      [-vCPUCountPerCore <Int32>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Met de cmdlet Update-AzVM wordt de status van een virtuele Azure-machine bijgewerkt naar de status van een object van een virtuele machine.

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 object voor een virtuele machine 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 -vCPUsPerCore $vCPUsCoreInitial -vCPUsAvailable $vCPUsAvailableInitial;
# The $vm.HardwareProfile.VmSizeProperties.VCPUsPerCore property is 2, and the $vm.HardwareProfile.VmSizeProperties.VCPUsAvailable property is 4.

Update-AzVm -ResourceGroupName $rgname -VM $vm -vCPUsAvailable $vCPUsAvailable1 -vCPUsPerCore $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
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
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
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure.

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

-EncryptionAtHost

De eigenschap EncryptionAtHost kan door de gebruiker in de aanvraag worden gebruikt om de 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
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
Accept pipeline input:	True
Accept wildcard characters:	False

-HostId

De id van de host

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

-IdentityId

Hiermee geeft u de lijst met gebruikersidentiteiten die zijn gekoppeld aan de virtuele machine. 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
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
Accept pipeline input:	False
Accept wildcard characters:	False

-MaxPrice

Hiermee geeft u de maximale prijs 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 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 die groter is 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
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
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
Accept pipeline input:	False
Accept wildcard characters:	False

-ProximityPlacementGroupId

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

Type:	String
Position:	Named
Default value:	None
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
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 mag maximaal 15 tags hebben.

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

-UserData

UserData voor de VM, die wordt gecodeerd met base-64. Klant mag hier geen geheimen doorgeven.

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

-vCPUCountAvailable

Hiermee geeft u het aantal vCPU's op 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 De lijst met alle beschikbare vm-grootten in een regio.

Type:	Int32
Position:	Named
Default value:	None
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 api-antwoord van de lijst met alle beschikbare vm-grootten in een regio. Als u deze eigenschap instelt op 1, betekent dit ook dat hyperthreading is uitgeschakeld.

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

-VM

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