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 = '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.

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 zobrazí výzvu 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 Uefi Nastavení, musí být nastavená na libovolnou zadanou hodnotu. Ve výchozím nastavení se Uefi Nastavení 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 vystavenou v odpovědi rozhraní API seznamu všech dostupných velikostí virtuálních počítačů v dané 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 v odpovědi Na seznam všech dostupných velikostí 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

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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

Sdílet prostřednictvím

Update-AzVM

Syntaxe

Description

Příklady

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

Příklad 2: Aktualizujte virtuální počítač tak, aby zakázal hyperthreading.

Parametry

-AsJob

-CapacityReservationGroupId

-Confirm

-DefaultProfile

-EnableSecureBoot

-EnableVtpm

-EncryptionAtHost

-HibernationEnabled

-HostId

-Id

-IdentityId

-IdentityType

-IfMatch

-IfNoneMatch

-MaxPrice

-NoWait

-OsDiskWriteAccelerator

-ProximityPlacementGroupId

-ResourceGroupName

-SecurityType

-Tag

-UltraSSDEnabled

-UserData

-vCPUCountAvailable

-vCPUCountPerCore

-VirtualMachineScaleSetId

-VM

-WhatIf

Vstupy

Výstupy

Další materiály

Sdílet prostřednictvím

Update-AzVM

Syntaxe

Description

Příklady

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

Příklad 2: Aktualizujte virtuální počítač tak, aby zakázal hyperthreading.

Parametry

-AsJob

-CapacityReservationGroupId

-Confirm

-DefaultProfile

-EnableSecureBoot

-EnableVtpm

-EncryptionAtHost

-HibernationEnabled

-HostId

-Id

-IdentityId

-IdentityType

-IfMatch

-IfNoneMatch

-MaxPrice

-NoWait

-OsDiskWriteAccelerator

-ProximityPlacementGroupId

-ResourceGroupName

-SecurityType

-Tag

-UltraSSDEnabled

-UserData

-vCPUCountAvailable

-vCPUCountPerCore

-VirtualMachineScaleSetId

-VM

-WhatIf

Vstupy

Výstupy

Související odkazy

Další materiály