Update-AzVM

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 Status eines virtuellen Azure-Computers auf den Zustand eines virtuellen Computerobjekts.

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 sie mithilfe des in der $VirtualMachine Variablen gespeicherten virtuellen Computerobjekts. Verwenden Sie zum Abrufen eines virtuellen Computerobjekts das Cmdlet Get-AzVM .

Beispiel 2: Aktualisieren eines virtuellen Computers zum Deaktivieren von Hyperthreading.

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

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

EncryptionAtHost-Eigenschaft kann vom Benutzer in der Anforderung verwendet werden, um die Hostverschlüsselung für den virtuellen Computer oder den Skalierungssatz des virtuellen Computers zu aktivieren oder zu deaktivieren. Dadurch wird die Verschlüsselung für alle Datenträger, einschließlich Ressourcen-/Temp-Datenträger, beim Host selbst aktiviert.

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

-HibernationEnabled

Das Flag, das die Funktion "Hibernation" 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ätsbezüge sind ARM-Ressourcen-IDs im Formular: '/abonnements/{subscriptionId}/resourceGroups/{resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/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 befindet sich 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 des Erstellens/Aktualisierens von VM/VMSS mit niedriger Priorität verglichen und der Vorgang wird nur erfolgreich ausgeführt, wenn der maxPrice größer ist als der aktuelle niedrige Prioritätspreis. Der maxPrice wird auch für die Aussetzung 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: jeder Dezimalwert, der größer als null ist. Beispiel: 0.01538. -1 gibt an, dass die VM/VMSS mit niedriger Priorität nicht aus Preisgründen entfernt werden sollte. Außerdem ist der Standard-Max-Preis -1, wenn sie von Ihnen nicht 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 einem Satz von Namenswertpaaren gekennzeichnet 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 aktiviert oder deaktiviert, um über eine oder mehrere verwaltete Datenträger mit UltraSSD_LRS Speicherkontotyp auf dem virtuellen Computer zu verfügen. Verwaltete Datenträger mit dem Speicherkontotyp UltraSSD_LRS können nur zu einem virtuellen Computer 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 die VM, die basis-64 codiert ist. Der Kunde sollte hier keine Geheimnisse übergeben.

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 im Anforderungstext nicht angegeben wird, soll das Standardverhalten auf den Wert von vCPUs festgelegt werden, der für diese VM-Größe in der API-Antwort der Liste aller verfügbaren virtuellen Computergrößen in einem Bereich verfügbar ist.

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

-vCPUCountPerCore

Gibt das vCPU-Verhältnis zu physischem Kernverhältnis an. Wenn diese Eigenschaft im Anforderungstext nicht angegeben wird, wird das Standardverhalten auf den Wert von vCPUsPerCore für die VM-Größe festgelegt, die in der API-Antwort der Liste aller verfügbaren virtuellen Computergrößen in einem Bereich 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 virtuelles Computerobjekt an. Verwenden Sie zum Abrufen eines virtuellen Computerobjekts das Cmdlet Get-AzVM. Dieses virtuelle Computerobjekt 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

Ähnliche Themen

• Get-AzVM
• New-AzVM
• Remove-AzVM
• Restart-AzVM
• Start-AzVM
• Stop-AzVM
• New-AzVMConfig