Dela via

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>]
      [-IfMatch <String>]
      [-IfNoneMatch <String>]
      [-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>]
      [-IfMatch <String>]
      [-IfNoneMatch <String>]
      [-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>]
      [-IfMatch <String>]
      [-IfNoneMatch <String>]
      [-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.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-CapacityReservationGroupId

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

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Confirm

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

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

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

Typ:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-EnableSecureBoot

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

Typ:Nullable<T>[Boolean]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-EnableVtpm

Anger om vTPM ska aktiveras på den virtuella datorn.

Typ:Nullable<T>[Boolean]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken: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.

Typ:Boolean
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-HibernationEnabled

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

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-HostId

Värdens ID

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Id

Anger resurs-ID för den virtuella datorn.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken: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}'

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-IdentityType

Den typ av identitet som används för den virtuella datorn. Giltiga värden är SystemAssigned, UserAssigned, SystemAssignedUserAssigned och None.

Typ:Nullable<T>[ResourceIdentityType]
Godkända värden:SystemAssigned, UserAssigned, SystemAssignedUserAssigned, None
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-IfMatch

används för att göra en begäran villkorsstyrd för PUT och andra icke-säkra metoder. Servern returnerar endast de begärda resurserna om resursen matchar något av de angivna ETag-värdena. Utelämna det här värdet för att alltid skriva över den aktuella resursen. Ange det senast synliga ETag-värdet för att förhindra att samtidiga ändringar skrivs över av misstag.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-IfNoneMatch

Används för att göra en begäran villkorsstyrd för GET- och HEAD-metoderna. Servern returnerar endast de begärda resurserna om inget av de angivna ETag-värdena matchar den aktuella entiteten. Används för att göra en begäran villkorsstyrd för GET- och HEAD-metoderna. Servern returnerar endast de begärda resurserna om inget av de angivna ETag-värdena matchar den aktuella entiteten. Ange till *för att tillåta att en ny postuppsättning skapas, men för att förhindra uppdatering av en befintlig postuppsättning. Andra värden resulterar i fel från servern eftersom de inte stöds.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken: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.

Typ:Double
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken: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.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-OsDiskWriteAccelerator

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

Typ:Boolean
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ProximityPlacementGroupId

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

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ResourceGroupName

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

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-SecurityType

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

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken: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.

Typ:Hashtable
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:Boolean
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken: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.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken: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.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken: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.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-VirtualMachineScaleSetId

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

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:PSVirtualMachine
Alias:VMProfile
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

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

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

String

PSVirtualMachine

Boolean

Utdata

PSAzureOperationResponse