Sdílet prostřednictvím

Update-AzVM

  • Reference
Modul:
Az.Compute

Aktualizuje stav virtuálního počítače Azure.

Syntaxe

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

Rutina Update-AzVM aktualizuje stav virtuálního počítače Azure na stav objektu virtuálního počítače.

Příklady

Příklad 1: Aktualizace virtuálního počítače

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

Tento příkaz aktualizuje virtuální počítač $VirtualMachine v ResourceGroup11. Příkaz ho aktualizuje pomocí objektu virtuálního počítače uloženého v proměnné $VirtualMachine. K získání objektu virtuálního počítače použijte rutinu Get-AzVM.

Příklad 2: Aktualizujte virtuální počítač tak, aby zakázal 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.

Parametry

-AsJob

Spusťte rutinu na pozadí a vraťte úlohu pro sledování průběhu.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-CapacityReservationGroupId

ID skupiny rezervací kapacity, která se používá k přidělení.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-EnableSecureBoot

Určuje, jestli má být na virtuálním počítači povolené zabezpečené spouštění.

Typ:Nullable<T>[Boolean]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-EnableVtpm

Určuje, jestli má být na virtuálním počítači povolený virtuální počítač vTPM.

Typ:Nullable<T>[Boolean]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-EncryptionAtHost

Vlastnost EncryptionAtHost může uživatel v požadavku použít k povolení nebo zakázání šifrování hostitele pro virtuální počítač nebo škálovací sadu virtuálních počítačů. Tím povolíte šifrování pro všechny disky, včetně samotného prostředku nebo dočasného disku v hostiteli.

Typ:Boolean
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-HibernationEnabled

Příznak, který povolí nebo zakáže funkci hibernace na virtuálním počítači.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-HostId

ID hostitele

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Id

Určuje ID prostředku virtuálního počítače.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-IdentityId

Určuje seznam identit uživatelů přidružených k virtuálnímu počítači. Odkazy na identitu uživatele budou ID prostředků ARM ve formuláři: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identityies/{identityName}.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-IdentityType

Typ identity používané pro virtuální počítač. Platné hodnoty jsou SystemAssigned, UserAssigned, SystemAssignedUserAssigned a None.

Typ:Nullable<T>[ResourceIdentityType]
Přípustné hodnoty:SystemAssigned, UserAssigned, SystemAssignedUserAssigned, None
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-IfMatch

slouží k podmíněnému požadavku pro PUT a další nebezpečné metody. Server vrátí požadované prostředky pouze v případě, že prostředek odpovídá jedné z uvedených hodnot značky ETag. Tuto hodnotu vynecháte, pokud chcete aktuální prostředek vždy přepsat. Zadejte naposledy zobrazenou hodnotu značky ETag, abyste zabránili náhodnému přepsání souběžných změn.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-IfNoneMatch

Používá se k podmíněnému požadavku pro metody GET a HEAD. Server vrátí požadované prostředky pouze v případě, že žádná z uvedených hodnot značky ETag neodpovídá aktuální entitě. Používá se k podmíněnému požadavku pro metody GET a HEAD. Server vrátí požadované prostředky pouze v případě, že žádná z uvedených hodnot značky ETag neodpovídá aktuální entitě. Pokud chcete povolit vytvoření nové sady záznamů, nastavte na *, ale chcete-li zabránit aktualizaci existující sady záznamů. Jiné hodnoty budou mít za následek chybu ze serveru, protože nejsou podporované.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-MaxPrice

Určuje maximální cenu, kterou jste ochotni zaplatit za virtuální počítač s nízkou prioritou nebo za VMSS. Tato cena je v amerických dolarech. Tato cena se porovná s aktuální cenou za nízkou prioritu pro velikost virtuálního počítače. Ceny se také porovnávají v době vytvoření/aktualizace virtuálního počítače nebo VMSS s nízkou prioritou a operace bude úspěšná, pouze pokud je maximální cena vyšší než aktuální cena za nízkou prioritu. Hodnota maxPrice se použije také k vyřazení virtuálního počítače s nízkou prioritou nebo služby VMSS, pokud aktuální cena s nízkou prioritou po vytvoření VM/VMSS překročí maximální cenu. Možné hodnoty jsou: jakákoli desetinná hodnota větší než nula. Příklad: 0.01538. -1 označuje, že virtuální počítač s nízkou prioritou nebo VMSS by neměl být vyřazen z důvodů ceny. Výchozí maximální cena je také -1, pokud ji neposkytujete.

Typ:Double
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-NoWait

Spustí operaci a vrátí se okamžitě před dokončením operace. Pokud chcete zjistit, jestli se operace úspěšně dokončila, použijte jiný mechanismus.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-OsDiskWriteAccelerator

Určuje, jestli má být na disku s operačním systémem povolený nebo zakázaný WriteAccelerator.

Typ:Boolean
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ProximityPlacementGroupId

ID prostředku skupiny umístění bezkontaktní komunikace, které se má použít s tímto virtuálním počítačem.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ResourceGroupName

Určuje název skupiny prostředků virtuálního počítače.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-SecurityType

Určuje typ zabezpečení virtuálního počítače. Aby bylo možné povolit UefiSettings, musí být nastavená na libovolnou zadanou hodnotu. Ve výchozím nastavení se UefiSettings nepovolí, pokud není tato vlastnost nastavená.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Tag

Určuje prostředky a skupiny prostředků, které lze označit sadou dvojic název-hodnota. Přidání značek k prostředkům umožňuje seskupit prostředky mezi skupinami prostředků a vytvořit vlastní zobrazení. Každý prostředek nebo skupina prostředků může mít maximálně 15 značek.

Typ:Hashtable
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-UltraSSDEnabled

Příznak, který povolí nebo zakáže schopnost mít na virtuálním počítači jeden nebo více spravovaných datových disků s typem účtu úložiště UltraSSD_LRS. Spravované disky s typem účtu úložiště UltraSSD_LRS lze přidat do virtuálního počítače pouze v případě, že je tato vlastnost povolená.

Typ:Boolean
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-UserData

UserData pro virtuální počítač, který bude kódován v base-64. Zákazník by zde neměl předávat žádné tajné kódy.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-vCPUCountAvailable

Určuje počet virtuálních procesorů dostupných pro virtuální počítač. Pokud tato vlastnost není v textu požadavku zadána, výchozí chování je nastavit ji na hodnotu virtuálních procesorů dostupných pro danou velikost virtuálního počítače v odpovědi rozhraní API Vypsat všechny dostupné velikosti virtuálních počítačů v oblasti.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-vCPUCountPerCore

Určuje poměr virtuálních procesorů k fyzickému jádru. Pokud tato vlastnost není zadána v textu požadavku výchozí chování je nastavena na hodnotu vCPUsPerCore pro velikost virtuálního počítače vystavené v odpovědi rozhraní API Vypsat všechny dostupné velikosti virtuálních počítačů v oblasti. Nastavení této vlastnosti na hodnotu 1 také znamená, že hyper-threading je zakázán.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-VirtualMachineScaleSetId

ID škálovací sady virtuálních počítačů, na kterou by měl být virtuální počítač aktualizován.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-VM

Určuje objekt místního virtuálního počítače. K získání objektu virtuálního počítače použijte rutinu Get-AzVM. Tento objekt virtuálního počítače obsahuje aktualizovaný stav virtuálního počítače.

Typ:PSVirtualMachine
Aliasy:VMProfile
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

String

PSVirtualMachine

Boolean

Výstupy

PSAzureOperationResponse