Update-AzVM

Referens

Modul:: Az.Compute

Uppdaterar tillståndet för en virtuell Azure-dator.

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

Update-AzVM-cmdleten uppdaterar tillståndet för en virtuell Azure-dator till tillståndet för ett virtuellt datorobjekt.

Exempel

Exempel 1: Uppdatera en virtuell dator

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

Det här kommandot uppdaterar den virtuella datorn, $VirtualMachine, i ResourceGroup11. Kommandot uppdaterar det med hjälp av det virtuella datorobjektet som lagras i variabeln $VirtualMachine. Om du vill hämta ett virtuellt datorobjekt använder du cmdleten Get-AzVM .

Exempel 2: Uppdatera en virtuell dator för att inaktivera hypertrådning.

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

Parametrar

-AsJob

Kör cmdleten i bakgrunden och returnera ett jobb för att spåra förloppet.

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

-CapacityReservationGroupId

ID för kapacitetsreservationsgruppen som används för allokering.

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

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

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

-EnableSecureBoot

Anger om säker start ska aktiveras på den virtuella datorn.

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

-EnableVtpm

Anger om vTPM ska aktiveras på den virtuella datorn.

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

-EncryptionAtHost

Egenskapen EncryptionAtHost kan användas av användaren i begäran för att aktivera eller inaktivera värdkryptering för den virtuella datorn eller vm-skalningsuppsättningen. Detta aktiverar krypteringen för alla diskar, inklusive resurs/temp-disk på själva värden.

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

-HibernationEnabled

Flaggan som aktiverar eller inaktiverar vilolägesfunktionen på den virtuella datorn.

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

-HostId

Värdens ID

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

-Id

Anger resurs-ID för den virtuella datorn.

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

-IdentityId

Anger listan över användaridentiteter som är associerade med den virtuella datorn. Användaridentitetsreferenserna är ARM-resurs-ID:n i formuläret: '/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

Den typ av identitet som används för den virtuella datorn. Giltiga värden är SystemAssigned, UserAssigned, SystemAssignedUserAssigned och 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

Anger det högsta pris som du är villig att betala för en virtuell dator/VMSS med låg prioritet. Det här priset är i us-dollar. Det här priset jämförs med det aktuella lågprioriteringspriset för VM-storleken. Dessutom jämförs priserna vid tidpunkten för skapande/uppdatering av virtuell dator/VMSS med låg prioritet och åtgärden lyckas bara om maxPrice är större än det aktuella priset med låg prioritet. MaxPrice används också för att avlägsna en virtuell dator med låg prioritet/VMSS om det aktuella priset med låg prioritet överskrider maxPriset efter skapandet av VM/VMSS. Möjliga värden är: ett decimalvärde som är större än noll. Exempel: 0.01538. -1 anger att den lågprioriterade virtuella datorn/VMSS inte ska avlägsnas av prisskäl. Dessutom är det högsta standardpriset -1 om det inte tillhandahålls av dig.

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

-NoWait

Startar åtgärden och returnerar omedelbart innan åtgärden har slutförts. Använd någon annan mekanism för att avgöra om åtgärden har slutförts.

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

-OsDiskWriteAccelerator

Anger om WriteAccelerator ska aktiveras eller inaktiveras på OS-disken.

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

-ProximityPlacementGroupId

Resurs-ID för närhetsplaceringsgruppen som ska användas med den här virtuella datorn.

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

-ResourceGroupName

Anger namnet på resursgruppen för den virtuella datorn.

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

-SecurityType

Anger SecurityType för den virtuella datorn. Det måste anges till ett angivet värde för att aktivera Uefi Inställningar. Som standard aktiveras inte Uefi Inställningar om inte den här egenskapen har angetts.

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

-Tag

Anger vilka resurser och resursgrupper som kan taggas med en uppsättning namn/värde-par. Genom att lägga till taggar i resurser kan du gruppera resurser mellan resursgrupper och skapa egna vyer. Varje resurs eller resursgrupp kan som mest ha 15 taggar.

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

-UltraSSDEnabled

Flaggan som aktiverar eller inaktiverar en funktion för att ha en eller flera hanterade datadiskar med UltraSSD_LRS lagringskontotyp på den virtuella datorn. Hanterade diskar med lagringskontotyp UltraSSD_LRS kan bara läggas till på en virtuell dator om den här egenskapen är aktiverad.

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

-UserData

UserData för den virtuella datorn, som kommer att vara base-64-kodad. Kunden bör inte skicka in några hemligheter här.

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

-vCPUCountAvailable

Anger antalet virtuella processorer som är tillgängliga för den virtuella datorn. När den här egenskapen inte anges i begärandetexten är standardbeteendet att ange värdet för vCPU:er som är tillgängliga för den virtuella datorstorleken som exponeras i API-svaret i Lista alla tillgängliga storlekar på virtuella datorer i en region.

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

-vCPUCountPerCore

Anger förhållandet mellan vCPU och fysisk kärna. När den här egenskapen inte anges i begärandetexten anges standardbeteendet till värdet för vCPUsPerCore för vm-storleken som exponeras i API-svaret i Lista alla tillgängliga storlekar på virtuella datorer i en region. Om du anger den här egenskapen till 1 innebär det också att hypertrådning är inaktiverat.

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

-VirtualMachineScaleSetId

ID för vm-skalningSeten som den virtuella datorn ska uppdateras till.

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

-VM

Anger ett lokalt virtuellt datorobjekt. Om du vill hämta ett virtuellt datorobjekt använder du cmdleten Get-AzVM. Det här objektet för den virtuella datorn innehåller det uppdaterade tillståndet för den virtuella datorn.

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

Indata

String

PSVirtualMachine

Boolean

Utdata

PSAzureOperationResponse

Update-AzVM

Syntax

Description

Exempel

Exempel 1: Uppdatera en virtuell dator

Exempel 2: Uppdatera en virtuell dator för att inaktivera hypertrådning.

Parametrar

-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

Indata

Utdata

Feedback

Ytterligare resurser

Update-AzVM

Syntax

Description

Exempel

Exempel 1: Uppdatera en virtuell dator

Exempel 2: Uppdatera en virtuell dator för att inaktivera hypertrådning.

Parametrar

-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

Indata

Utdata

Relaterade länkar

Feedback

Ytterligare resurser