Sdílet prostřednictvím


Update-AzVM

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

Syntax

ResourceGroupNameParameterSetName (Výchozí)

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>]
    [-AlignRegionalDisksToVMZone <Boolean>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ExplicitIdentityParameterSet

Update-AzVM
    [-ResourceGroupName] <String>
    -VM <PSVirtualMachine>
    -IdentityType <ResourceIdentityType>
    [-Tag <Hashtable>]
    [-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>]
    [-AlignRegionalDisksToVMZone <Boolean>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

IdParameterSetName

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>]
    [-AlignRegionalDisksToVMZone <Boolean>]
    [-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

-AlignRegionalDisksToVMZone

Určuje, jestli se mají místní disky zarovnat nebo přesunout do zóny virtuálního počítače. To platí jenom pro virtuální počítače se sadou vlastností umístění. Upozorňujeme, že tato změna je nevratná.

Vlastnosti parametru

Typ:

Nullable<T>[Boolean]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-AsJob

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

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-CapacityReservationGroupId

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

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Confirm

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

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False
Aliasy:viz

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-DefaultProfile

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

Vlastnosti parametru

Typ:IAzureContextContainer
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-EnableSecureBoot

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

Vlastnosti parametru

Typ:

Nullable<T>[Boolean]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-EnableVtpm

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

Vlastnosti parametru

Typ:

Nullable<T>[Boolean]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů: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.

Vlastnosti parametru

Typ:Boolean
Default value:False
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-HibernationEnabled

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

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-HostId

ID hostitele

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-Id

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

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

IdParameterSetName
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů: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}.

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

ExplicitIdentityParameterSet
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-IdentityType

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

Vlastnosti parametru

Typ:

Nullable<T>[ResourceIdentityType]

Default value:None
Přípustné hodnoty:SystemAssigned, UserAssigned, SystemAssignedUserAssigned, None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

ExplicitIdentityParameterSet
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů: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é.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů: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.

Vlastnosti parametru

Typ:Double
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů: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.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-OsDiskWriteAccelerator

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

Vlastnosti parametru

Typ:Boolean
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-ResourceGroupName

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

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

ResourceGroupNameParameterSetName
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False
ExplicitIdentityParameterSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů: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á.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů: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.

Vlastnosti parametru

Typ:Hashtable
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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á.

Vlastnosti parametru

Typ:Boolean
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů: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.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů: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.

Vlastnosti parametru

Typ:Int32
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů: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.

Vlastnosti parametru

Typ:Int32
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-VirtualMachineScaleSetId

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

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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.

Vlastnosti parametru

Typ:PSVirtualMachine
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:VMProfile

Sady parametrů

(All)
Position:Named
Povinné:True
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Wi

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

String

PSVirtualMachine

Boolean

Výstupy

PSAzureOperationResponse