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>]
      [-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

Cmdleten Update-AzVM 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
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
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
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Autentiseringsuppgifterna, kontot, klientorganisationen och prenumerationen som används för kommunikation med Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Accept pipeline input:False
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/temporär disk på själva värden.

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

-HibernationEnabled

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

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

-HostId

Värdens ID

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

-Id

Anger resurs-ID för den virtuella datorn.

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

-IdentityId

Anger listan över användaridentiteter som är associerade med den virtuella datorn. Referenserna för användaridentiteten är ARM-resurs-ID:n i formatet: '/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

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
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 lågprioritetspriset. MaxPrice kommer också att användas för att ta bort en virtuell dator/VMSS med låg prioritet om det aktuella lågprioritetspriset överskrider maxPrice 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 virtuella datorn/VMSS med låg prioritet 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
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
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
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
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

Anger namnet på den virtuella datorns resursgrupp.

Type:String
Position:0
Default value:None
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 en resursgrupp kan ha högst 15 taggar.

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

-vCPUCountAvailable

Anger antalet virtuella processorer som är tillgängliga för den virtuella datorn. Om 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 VM-storleken som exponeras i API-svaret i Lista alla tillgängliga storlekar på virtuella datorer i en region.

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

-vCPUCountPerCore

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

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

-VM

Anger ett lokalt virtuellt datorobjekt. Om du vill hämta ett virtuellt datorobjekt använder du cmdleten Get-AzVM. 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
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
Accept pipeline input:False
Accept wildcard characters:False

Indata

String

PSVirtualMachine

Boolean

Utdata

PSAzureOperationResponse