Update-AzVM

  • Referenz
Modul:
Az.Compute

Aktualisiert den Status des virtuellen Azure-Computers.

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

Beschreibung

Das Cmdlet Update-AzVM aktualisiert den Zustand eines virtuellen Azure-Computers in den Zustand eines VM-Objekts.

Beispiele

Beispiel 1: Aktualisieren eines virtuellen Computers

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

Dieser Befehl aktualisiert den virtuellen Computer $VirtualMachine in ResourceGroup11. Der Befehl aktualisiert es mithilfe des vm-Objekts, das in der variablen $VirtualMachine gespeichert ist. Verwenden Sie zum Abrufen eines VM-Objekts das Cmdlet Get-AzVM .

Beispiel 2: Aktualisieren Sie einen virtuellen Computer, um Hyperthreading zu deaktivieren.

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

Parameter

-AsJob

Führen Sie das Cmdlet im Hintergrund aus, und geben Sie einen Auftrag zurück, um den Fortschritt nachzuverfolgen.

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

-CapacityReservationGroupId

ID der Kapazitätsreservierungsgruppe, die zum Zuweisen verwendet wird.

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

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

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

-EncryptionAtHost

Die EncryptionAtHost-Eigenschaft kann vom Benutzer in der Anforderung verwendet werden, um die Hostverschlüsselung für den virtuellen Computer oder die VM-Skalierungsgruppe zu aktivieren oder zu deaktivieren. Dadurch wird die Verschlüsselung für alle Datenträger aktiviert, einschließlich ressourcen-/temporärer Datenträger auf dem Host selbst.

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

-HibernationEnabled

Das Flag, das die Ruhezustandsfunktion auf dem virtuellen Computer aktiviert oder deaktiviert.

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

-HostId

Die ID des Hosts

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

-Id

Gibt die Ressourcen-ID des virtuellen Computers an.

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

-IdentityId

Gibt die Liste der Benutzeridentitäten an, die dem virtuellen Computer zugeordnet sind. Die Benutzeridentitätsverweise sind ARM-Ressourcen-IDs in der Form "/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

Der Identitätstyp, der für den virtuellen Computer verwendet wird. Gültige Werte sind SystemAssigned, UserAssigned, SystemAssignedUserAssigned und 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

Gibt den maximalen Preis an, den Sie für eine VM/VMSS mit niedriger Priorität bezahlen möchten. Dieser Preis ist in US-Dollar. Dieser Preis wird mit dem aktuellen niedrigen Prioritätspreis für die VM-Größe verglichen. Außerdem werden die Preise zum Zeitpunkt der Erstellung/Aktualisierung einer VM/VMSS mit niedriger Priorität verglichen, und der Vorgang wird nur erfolgreich ausgeführt, wenn der maxPrice größer als der aktuelle niedrige Prioritätspreis ist. Der maxPrice wird auch zum Entfernen einer VM/VMSS mit niedriger Priorität verwendet, wenn der aktuelle niedrige Prioritätspreis nach der Erstellung von VM/VMSS über den maxPrice hinausgeht. Mögliche Werte sind: ein beliebiger Dezimalwert größer als 00. Beispiel: 0,01538. -1 gibt an, dass die VM/VMSS mit niedriger Priorität aus Preisgründen nicht entfernt werden sollte. Außerdem ist der maximale Standardpreis -1, wenn er nicht von Ihnen bereitgestellt wird.

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

-NoWait

Startet den Vorgang und gibt sofort zurück, bevor der Vorgang abgeschlossen ist. Um festzustellen, ob der Vorgang erfolgreich abgeschlossen wurde, verwenden Sie einen anderen Mechanismus.

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

-OsDiskWriteAccelerator

Gibt an, ob WriteAccelerator auf dem Betriebssystemdatenträger aktiviert oder deaktiviert werden soll.

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

-ProximityPlacementGroupId

Die Ressourcen-ID der Näherungsplatzierungsgruppe, die mit diesem virtuellen Computer verwendet werden soll.

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

-ResourceGroupName

Gibt den Namen der Ressourcengruppe des virtuellen Computers an.

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

-Tag

Gibt die Ressourcen und Ressourcengruppen an, die mit einer Reihe von Name-Wert-Paaren markiert werden können. Das Hinzufügen von Tags zu Ressourcen ermöglicht das Gruppieren von Ressourcen über Ressourcengruppen hinweg sowie das Erstellen eigener Ansichten. Jede Ressource oder Ressourcengruppe kann maximal 15 Tags haben.

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

-UltraSSDEnabled

Das Flag, das eine Funktion zum Verwenden eines oder mehrerer verwalteter Datenträger mit UltraSSD_LRS Speicherkontotyp auf dem virtuellen Computer aktiviert oder deaktiviert. Verwaltete Datenträger mit dem Speicherkontotyp UltraSSD_LRS können einem virtuellen Computer nur hinzugefügt werden, wenn diese Eigenschaft aktiviert ist.

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

-UserData

UserData für den virtuellen Computer, der Base64-codiert ist. Der Kunde sollte hier keine Geheimnisse weitergeben.

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

-vCPUCountAvailable

Gibt die Anzahl der für den virtuellen Computer verfügbaren vCPUs an. Wenn diese Eigenschaft nicht im Anforderungstext angegeben wird, wird sie standardmäßig auf den Wert der vCPUs festgelegt, die für diese VM-Größe verfügbar sind, die in der API-Antwort von List all available virtual machine size in a region verfügbar sind.

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

-vCPUCountPerCore

Gibt das Verhältnis von vCPU zu physischem Kern an. Wenn diese Eigenschaft im Anforderungstext nicht angegeben ist, wird das Standardverhalten auf den Wert von vCPUsPerCore für die VM-Größe festgelegt, die in der API-Antwort von List all available virtual machine size in a region verfügbar ist. Das Festlegen dieser Eigenschaft auf 1 bedeutet auch, dass Hyperthreading deaktiviert ist.

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

-VM

Gibt ein lokales VM-Objekt an. Verwenden Sie zum Abrufen eines VM-Objekts das Cmdlet Get-AzVM. Dieses VM-Objekt enthält den aktualisierten Zustand für den virtuellen Computer.

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

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

Eingaben

String

PSVirtualMachine

Boolean

Ausgaben

PSAzureOperationResponse