Megosztás a következőn keresztül:

Update-AzVM

  • Referencia
Modul:
Az.Compute

Azure-beli virtuális gép állapotának frissítése.

Syntax

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

Az Update-AzVM parancsmag frissíti egy Azure-beli virtuális gép állapotát egy virtuálisgép-objektum állapotára.

Példák

1. példa: Virtuális gép frissítése

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

Ez a parancs frissíti az $VirtualMachine virtuális gépet a ResourceGroup11-ben. A parancs a $VirtualMachine változóban tárolt virtuálisgép-objektum használatával frissíti. Virtuálisgép-objektum beszerzéséhez használja a Get-AzVM parancsmagot.

2. példa: Virtuális gép frissítése a hyperthreading letiltásához.

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

Paraméterek

-AsJob

Futtassa a parancsmagot a háttérben, és adjon vissza egy feladatot a folyamat nyomon követéséhez.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-CapacityReservationGroupId

A lefoglaláshoz használt kapacitásfoglalási csoport azonosítója.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Típus:SwitchParameter
Aliasok:cf
Position:Named
Alapértelmezett érték:False
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.

Típus:IAzureContextContainer
Aliasok:AzContext, AzureRmContext, AzureCredential
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-EnableSecureBoot

Megadja, hogy engedélyezni kell-e a biztonságos rendszerindítást a virtuális gépen.

Típus:Nullable<T>[Boolean]
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-EnableVtpm

Megadja, hogy a virtuális gépen engedélyezve legyen-e a vTPM.

Típus:Nullable<T>[Boolean]
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-EncryptionAtHost

A EncryptionAtHost tulajdonságot a felhasználó használhatja a kérelemben a virtuális gép vagy virtuálisgép-méretezési csoport gazdagéptitkosításának engedélyezésére vagy letiltására. Ez lehetővé teszi az összes lemez titkosítását, beleértve magát a gazdagépen található Resource/Temp lemezt is.

Típus:Boolean
Position:Named
Alapértelmezett érték:False
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-HibernationEnabled

A virtuális gépen a hibernálási képességet engedélyező vagy letiltó jelző.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-HostId

A gazdagép azonosítója

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-Id

Megadja a virtuális gép erőforrás-azonosítóját.

Típus:String
Position:0
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-IdentityId

Megadja a virtuális géphez társított felhasználói identitások listáját. A felhasználói identitáshivatkozások arm-erőforrásazonosítók lesznek a következő formában: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identityes/{identityName}"

Típus:String[]
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-IdentityType

A virtuális géphez használt identitás típusa. Az érvényes értékek: SystemAssigned, UserAssigned, SystemAssignedUserAssigned és None.

Típus:Nullable<T>[ResourceIdentityType]
Elfogadott értékek:SystemAssigned, UserAssigned, SystemAssignedUserAssigned, None
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-IfMatch

a PUT és más nem biztonságos metódusok feltételessé tették a kéréseket. A kiszolgáló csak akkor adja vissza a kért erőforrásokat, ha az erőforrás megfelel a felsorolt ETag-értékek egyikének. Hagyja ki ezt az értéket, hogy mindig felülírja az aktuális erőforrást. Adja meg az utolsóként látott ETag értéket, hogy megakadályozza az egyidejű módosítások véletlen felülírását.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-IfNoneMatch

A GET és a HEAD metódusok kérésének feltételessé tétele. A kiszolgáló csak akkor adja vissza a kért erőforrásokat, ha a felsorolt ETag-értékek egyike sem felel meg az aktuális entitásnak. A GET és a HEAD metódusok kérésének feltételessé tétele. A kiszolgáló csak akkor adja vissza a kért erőforrásokat, ha a felsorolt ETag-értékek egyike sem felel meg az aktuális entitásnak. A "*" beállítással új rekordhalmaz hozható létre, de a meglévő rekordkészletek frissítésének megakadályozása érdekében. A többi érték hibát fog eredményezni a kiszolgálótól, mivel azok nem támogatottak.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-MaxPrice

Meghatározza az alacsony prioritású virtuális gépek/VMSS-k maximális árát. Ez az ár amerikai dollárban van. Ez az ár a virtuális gép méretének jelenlegi alacsony prioritású árával lesz összehasonlítva. Emellett az árakat az alacsony prioritású virtuális gép/VMSS létrehozása/frissítésekor hasonlítják össze, és a művelet csak akkor lesz sikeres, ha a maximális Ár nagyobb a jelenlegi alacsony prioritású árnál. A maxPrice az alacsony prioritású virtuális gép/VMSS kiürítésére is használható, ha az aktuális alacsony prioritású ár meghaladja a maxPrice értéket a virtuális gép/VMSS létrehozása után. A lehetséges értékek a következők: a nullánál nagyobb decimális értékek. Példa: 0.01538. A -1 azt jelzi, hogy az alacsony prioritású virtuális gépet/VMSS-t ár miatt nem szabad kizárni. Emellett az alapértelmezett maximális ár -1, ha ön nem adja meg.

Típus:Double
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-NoWait

Elindítja a műveletet, és azonnal visszatér, mielőtt a művelet befejeződik. Annak megállapításához, hogy a művelet sikeresen befejeződött-e, használjon más mechanizmust.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-OsDiskWriteAccelerator

Megadja, hogy a WriteAccelerator engedélyezve legyen vagy le legyen tiltva az operációsrendszer-lemezen.

Típus:Boolean
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ProximityPlacementGroupId

A virtuális géppel használni kívánt közelségi elhelyezési csoport erőforrás-azonosítója.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ResourceGroupName

Megadja a virtuális gép erőforráscsoportjának nevét.

Típus:String
Position:0
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-SecurityType

A virtuális gép SecurityType tulajdonságát adja meg. Az UefiSettings engedélyezéséhez minden megadott értékre be kell állítani. Alapértelmezés szerint az UefiSettings csak akkor lesz engedélyezve, ha ez a tulajdonság be van állítva.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-Tag

Megadja, hogy mely erőforrások és erőforráscsoportok címkézhetők meg név-érték párokkal. Ha címkéket ad hozzá az erőforrásokhoz, az erőforrásokat az erőforráscsoportok között csoportosíthatja, és saját nézeteket hozhat létre. Minden erőforrás vagy erőforráscsoport legfeljebb 15 címkével rendelkezhet.

Típus:Hashtable
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-UltraSSDEnabled

Az a jelző, amely lehetővé teszi vagy letiltja, hogy egy vagy több felügyelt adatlemez UltraSSD_LRS tárfióktípussal rendelkezzen a virtuális gépen. A tárfiók típusú felügyelt lemezek UltraSSD_LRS csak akkor vehetők fel virtuális gépekre, ha ez a tulajdonság engedélyezve van.

Típus:Boolean
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-UserData

UserData a virtuális géphez, amely a base-64 kódolású lesz. Az ügyfélnek itt nem szabad titkos kulcsokat átadnia.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-vCPUCountAvailable

A virtuális géphez elérhető vCPU-k számát adja meg. Ha ez a tulajdonság nincs megadva a kérelem törzsében, az alapértelmezett viselkedés az, hogy az adott virtuálisgép-mérethez elérhető virtuálisgép-mérethez elérhető értékre állítja azt a régióban elérhető összes virtuálisgép-méret listájának API-válaszában.

Típus:Int32
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-vCPUCountPerCore

Megadja a vCPU és a fizikai mag arányát. Ha ez a tulajdonság nincs megadva a kérelem törzsében, az alapértelmezett viselkedés a virtuálisgép-mérethez tartozó vCPUsPerCore értékre van állítva a régióban elérhető összes virtuálisgép-méret listázása API-válaszában. A tulajdonság 1 értékre állítása azt is jelenti, hogy a hyper-threading le van tiltva.

Típus:Int32
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-VirtualMachineScaleSetId

Annak a virtuálisgép-méretezési csoportnak az azonosítója, amellyel a virtuális gépet frissíteni kell.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-VM

Egy helyi virtuálisgép-objektumot határoz meg. Virtuálisgép-objektum beszerzéséhez használja a Get-AzVM parancsmagot. Ez a virtuálisgép-objektum tartalmazza a virtuális gép frissített állapotát.

Típus:PSVirtualMachine
Aliasok:VMProfile
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Típus:SwitchParameter
Aliasok:wi
Position:Named
Alapértelmezett érték:False
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

Bevitelek

String

PSVirtualMachine

Boolean

Kimenetek

PSAzureOperationResponse