Das Cmdlet Update-AzVM aktualisiert den Status eines Azure virtuellen Computers auf den Zustand eines virtuellen Computerobjekts.
Verwenden Sie PreferredVMSize in jedem Parametersatz, um die Vorschau FlexProfile.PreferredVMSizefestzulegen.
Azure können die bevorzugte Größe oder eine kompatible Alternative basierend auf Kapazität und Platzierung bereitstellen.
Dieser Parameter setzt in der ausgehenden HardwareProfile.VmSize Anforderung außer Kraft, ohne die Eingabeobjekt oder HardwareProfileFlexProfiledas Eingabeobjekt stummzuschalten.
Wenn sie weggelassen wird, werden flexProfile des Eingabeobjekts und HardwareProfile.VmSize in der Anforderung beibehalten.
Um zu FlexProfile zu wechseln, indem Sie das Objekt direkt bearbeiten, legen Sie es fest FlexProfile.PreferredVMSize und löschen HardwareProfile.VmSize Sie vor dem Aufrufen von Update-AzVM.
Um dies zu deaktivieren, legen Sie einen festen HardwareProfile.VmSizeWert FlexProfile$null fest; lassen Sie "PreferredVMSize" aus.
Bei einem GET-to-Update-Roundtrip einer vorhandenen FlexProfile-VM behält das Cmdlet flexProfile und den in der Anforderung gemeldeten HardwareProfile.VmSize Dienst bei, ohne das Eingabeobjekt zu ändern.
FlexProfile ist ein Vorschaufeature, das die Registrierung des Microsoft.Compute/FlexProfileEnabled Abonnementfeatures und der Verfügbarkeit in der Zielregion erfordert.
Unterstützte VM-Familien variieren je nach Region. Azure überprüft nicht unterstützte Platzierungen und leere Zeichenfolgen mit bevorzugter Größe.
Beispiele
Beispiel 1: Aktualisieren eines virtuellen Computers
Mit diesem Befehl wird der virtuelle Computer $VirtualMachine in ResourceGroup11 aktualisiert.
Der Befehl aktualisiert ihn mithilfe des virtuellen Computerobjekts, das in der variablen $VirtualMachine gespeichert ist.
Verwenden Sie das Cmdlet "Get-AzVM ", um ein Objekt eines virtuellen Computers abzurufen.
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 = ConvertTo-SecureString -String "****" -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.
In diesem Beispiel wird ein virtueller Computer aktualisiert, sodass er explizit von einer Kapazitätsreservierungszuweisung abgemeldet wird und stattdessen öffentlich verfügbare Kapazität verbraucht.
Beispiel 5: Aktualisieren einer VM für die Verwendung einer bevorzugten Größe
In diesem Beispiel wird die feste Größe der Anforderung mit FlexProfile außer Kraft gesetzt, ohne sich zu ändern $vm.
Das Abonnement muss für die Vorschau registriert sein, und die Region des virtuellen Computers muss es unterstützen.
Rufen Sie den virtuellen Computer erneut ab, um das aktualisierte Modell zu überprüfen.
Beispiel 6: Wechseln zu FlexProfile durch Bearbeiten des VM-Objekts
Wenn Sie einen virtuellen Computer mit fester Größe wechseln, indem Sie das Modell direkt bearbeiten, löschen Sie VmSize , sodass die Anforderung nicht sowohl eine feste Größe als auch FlexProfile enthält.
Die Verwendung von PreferredVMSize wie im vorherigen Beispiel behandelt die ausgehende Anforderung ohne diese Objektbearbeitungen.
Beispiel 7: Beibehalten von FlexProfile in einer GET-to-Update-Roundtrip
Bei einer vorhandenen FlexProfile-VM behält dies beim Aktualisieren von Tags die flexProfile und den Dienst bei HardwareProfile.VmSize .
Für keine Eigenschaft wird geändert $vm.
Verwenden Sie die Modellansicht von Get-AzVM ohne Status.
Beispiel 8: Abmelden von FlexProfile und Verwenden einer festen Größe
In diesem Beispiel werden FlexProfile gelöscht und eine feste Größe angefordert. Geben Sie "PreferredVMSize" beim Abmelden nicht an. Azure überprüft, ob die angeforderte Größe und Platzierung unterstützt werden.
Parameter
-AlignRegionalDisksToVMZone
Gibt an, ob die regionalen Datenträger an die VM-Zone ausgerichtet/verschoben werden sollen. Dies gilt nur für VMs mit einem Platzierungseigenschaftssatz. Bitte beachten Sie, dass diese Änderung unumkehrbar ist.
Gibt an, dass der virtuelle Computer explizit von einer Kapazitätsreservierungszuweisung abgemeldet wird.
Wenn festgelegt, wird der virtuelle Computer nicht implizit oder explizit mit einer Kapazitätsreservierung verknüpft und verbraucht stattdessen öffentlich verfügbare Kapazität.
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 auf dem Host selbst aktiviert.
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}'
Der Identitätstyp, der für den virtuellen Computer verwendet wird. Gültige Werte sind "SystemAssigned", "UserAssigned", "SystemAssignedUserAssigned" und "None".
wird verwendet, um eine Anforderung für die PUT- und andere nicht sichere Methoden bedingt zu stellen. Der Server gibt nur die angeforderten Ressourcen zurück, wenn die Ressource mit einem der aufgelisteten ETag-Werte übereinstimmt. Lassen Sie diesen Wert aus, um die aktuelle Ressource immer zu überschreiben. Geben Sie den zuletzt gesehenen ETag-Wert an, um zu verhindern, dass gleichzeitige Änderungen versehentlich überschrieben werden.
Wird verwendet, um eine Anforderung für die GET- und HEAD-Methoden bedingt zu machen. Der Server gibt nur die angeforderten Ressourcen zurück, wenn keiner der aufgelisteten ETag-Werte mit der aktuellen Entität übereinstimmt. Wird verwendet, um eine Anforderung für die GET- und HEAD-Methoden bedingt zu machen. Der Server gibt nur die angeforderten Ressourcen zurück, wenn keiner der aufgelisteten ETag-Werte mit der aktuellen Entität übereinstimmt. Legen Sie auf '*' fest, damit ein neuer Datensatzsatz erstellt werden kann, aber um zu verhindern, dass ein vorhandener Datensatzsatz aktualisiert wird. Andere Werte führen zu Einem Fehler vom Server, da sie nicht unterstützt werden.
Gibt den maximalen Preis an, den Sie für eine VM/VMSS mit niedriger Priorität bezahlen möchten. Dieser Preis liegt 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 als der aktuelle Preis mit niedriger Priorität ist. Der maxPrice wird auch verwendet, um eine VM/VMSS mit niedriger Priorität zu entfernen, wenn der aktuelle Preis mit niedriger Priorität nach der Erstellung von VM/VMSS über den maximalen Preis hinausgeht. Mögliche Werte sind: ein dezimaler Wert größer als Null. Beispiel: 0.01538. -1 gibt an, dass die VM/VMSS mit niedriger Priorität aus Preisgründen nicht entfernt werden sollte. Außerdem wird der standardmäßige Höchstpreis -1, wenn er nicht von Ihnen bereitgestellt wird.
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.
Gibt die bevorzugte VM-Größe für die Vorschau flexProfile an, z. B Standard_D4s_v5. .
Azure können basierend auf Kapazität und Platzierung eine kompatible Alternative auswählen.
In allen Parametersätzen setzt dieser Parameter die ausgehenden Anforderungen HardwareProfile.VmSize außer Kraft und legt sie fest FlexProfile.PreferredVMSize , ohne das Hardwareprofil des Eingabeobjekts oder FlexProfile stummzuschalten.
Wenn sie nicht angegeben wird, werden sowohl die Eingabe FlexProfile als auch vmSize in der Anforderung beibehalten, einschließlich der vom Dienst gemeldeten Größe einer vorhandenen FlexProfile-VM.
Um zu wechseln, indem Sie das Objekt direkt bearbeiten, legen Sie FlexProfile fest und löschen VmSize. Deaktivieren Sie FlexProfile, legen Sie eine feste VmSize fest, und lassen Sie diesen Parameter aus.
Für dieses Feature ist eine Vorschauregistrierung und regionale Verfügbarkeit erforderlich. Azure überprüft nicht unterstützte Platzierungen und leere Zeichenfolgen.
Gibt die API-Version an, um zu bestimmen, welche Version des Konfigurationsschemas für geplante Ereignisse bereitgestellt wird. Format: JJJJ-MM-TT. Verfügbare API-Versionen finden Sie unter https://learn.microsoft.com/rest/api/compute/scheduled-events.
Gibt den SecurityType des virtuellen Computers an. Sie muss auf einen beliebigen angegebenen Wert festgelegt werden, um UefiSettings zu aktivieren. Standardmäßig ist UefiSettings nur aktiviert, wenn diese Eigenschaft festgelegt ist.
Gibt die Ressourcen und Ressourcengruppen an, die mit einem Satz von Name-Wert-Paaren markiert werden können.
Durch das Hinzufügen von Tags zu Ressourcen können Sie Ressourcen in Ressourcengruppen gruppieren und eigene Ansichten erstellen.
Jede Ressource oder Ressourcengruppe kann maximal 15 Tags enthalten.
Das Kennzeichen, das eine Funktion aktiviert oder deaktiviert, um einen oder mehrere verwaltete Datenträger mit UltraSSD_LRS Speicherkontotyp auf dem virtuellen Computer zu verwenden.
Verwaltete Datenträger mit Speicherkontotyp UltraSSD_LRS können einem virtuellen Computer nur hinzugefügt werden, wenn diese Eigenschaft aktiviert ist.
Gibt die Anzahl der für den virtuellen Computer verfügbaren vCPUs an. Wenn diese Eigenschaft nicht im Anforderungstext angegeben ist, ist das Standardverhalten, es auf den Wert von vCPUs festzulegen, der für diese VM-Größe verfügbar ist, die in api-Antwort von Auflisten aller verfügbaren virtuellen Computergrößen in einer Region.
Gibt das vCPU-Verhältnis zum physischen Kernverhältnis an. Wenn diese Eigenschaft nicht im Anforderungstext angegeben ist, wird das Standardverhalten auf den Wert von vCPUsPerCore für die VM-Größe festgelegt, die in api-Antwort von Auflisten aller verfügbaren virtuellen Computergrößen in einer Region. Das Festlegen dieser Eigenschaft auf 1 bedeutet auch, dass Hyperthreading deaktiviert ist.
Gibt ein objekt eines lokalen virtuellen Computers an.
Verwenden Sie das Cmdlet "Get-AzVM ", um ein Objekt eines virtuellen Computers abzurufen.
Dieses Objekt des virtuellen Computers enthält den aktualisierten Zustand für den virtuellen Computer.
Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Die Quelle für diesen Inhalt finden Sie auf GitHub, wo Sie auch Issues und Pull Requests erstellen und überprüfen können. Weitere Informationen finden Sie in unserem Leitfaden für Mitwirkende.