Update-AzVM

  • Başvuru
Modül:
Az.Compute

Azure sanal makinesinin durumunu güncelleştirir.

Sözdizimi

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

Update-AzVM cmdlet'i bir Azure sanal makinesinin durumunu bir sanal makine nesnesinin durumuna güncelleştirir.

Örnekler

Örnek 1: Sanal makineyi güncelleştirme

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

Bu komut ResourceGroup11'de $VirtualMachine sanal makineyi güncelleştirir. komutu, $VirtualMachine değişkeninde depolanan sanal makine nesnesini kullanarak bunu güncelleştirir. Bir sanal makine nesnesi almak için Get-AzVM cmdlet'ini kullanın.

Örnek 2: Hiper iş parçacığı oluşturmayı devre dışı bırakmak için bir sanal makineyi güncelleştirin.

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

Parametreler

-AsJob

Cmdlet'i arka planda çalıştırın ve ilerleme durumunu izlemek için bir İş döndürin.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-CapacityReservationGroupId

Ayırmak için kullanılan kapasite rezervasyon Grubunun kimliği.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tür:SwitchParameter
Diğer adlar:cf
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.

Tür:IAzureContextContainer
Diğer adlar:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-EnableSecureBoot

Sanal makinede güvenli önyüklemenin etkinleştirilip etkinleştirilmeymeyeceğini belirtir.

Tür:Nullable<T>[Boolean]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-EnableVtpm

Sanal makinede vTPM'nin etkinleştirilip etkinleştirilmeymeyeceğini belirtir.

Tür:Nullable<T>[Boolean]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-EncryptionAtHost

EncryptionAtHost özelliği, kullanıcı tarafından istekte sanal makine veya sanal makine ölçek kümesi için Konak Şifrelemesi'ni etkinleştirmek veya devre dışı bırakmak için kullanılabilir. Bu, ana bilgisayarın kendisinde Kaynak/Geçici disk de dahil olmak üzere tüm diskler için şifrelemeyi etkinleştirir.

Tür:Boolean
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-HibernationEnabled

VM'de hazırda bekletme özelliğini etkinleştiren veya devre dışı bırakan bayrak.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-HostId

Ana Bilgisayarın Kimliği

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Id

Sanal makinenin kaynak kimliğini belirtir.

Tür:String
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-IdentityId

Sanal makineyle ilişkili kullanıcı kimliklerinin listesini belirtir. Kullanıcı kimliği başvuruları şu biçimde ARM kaynak kimlikleri olacaktır: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identities/{identityName}'

Tür:String[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-IdentityType

Sanal makine için kullanılan kimlik türü. Geçerli değerler SystemAssigned, UserAssigned, SystemAssignedUserAssigned ve None değerleridir.

Tür:Nullable<T>[ResourceIdentityType]
Kabul edilen değerler:SystemAssigned, UserAssigned, SystemAssignedUserAssigned, None
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-IfMatch

PUT ve diğer güvenli olmayan yöntemler için koşullu istekte bulunmak için kullanılır. Sunucu yalnızca kaynak listelenen ETag değerlerinden biriyle eşleşiyorsa istenen kaynakları döndürür. Geçerli kaynağın üzerine her zaman yazmak için bu değeri atla. Eşzamanlı değişikliklerin yanlışlıkla üzerine yazılmasını önlemek için son görülen ETag değerini belirtin.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-IfNoneMatch

GET ve HEAD yöntemleri için koşullu istek yapmak için kullanılır. Sunucu yalnızca listelenen ETag değerlerinin hiçbiri geçerli varlıkla eşleşmiyorsa istenen kaynakları döndürür. GET ve HEAD yöntemleri için koşullu istek yapmak için kullanılır. Sunucu yalnızca listelenen ETag değerlerinin hiçbiri geçerli varlıkla eşleşmiyorsa istenen kaynakları döndürür. Yeni bir kayıt kümesinin oluşturulmasına izin vermek, ancak var olan bir kayıt kümesinin güncelleştirilmesini önlemek için '*' olarak ayarlayın. Desteklenmeyen diğer değerler sunucudan hatayla sonuçlanır.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-MaxPrice

Düşük öncelikli bir VM/VMSS için ödemek istediğiniz maksimum fiyatı belirtir. Bu fiyat ABD Doları cinsindendir. Bu fiyat, VM boyutu için geçerli düşük öncelikli fiyatla karşılaştırılır. Ayrıca, düşük öncelikli VM/VMSS oluşturma/güncelleştirme sırasında fiyatlar karşılaştırılır ve işlem ancak maxPrice geçerli düşük öncelikli fiyattan büyükse başarılı olur. MaxPrice, vm/VMSS oluşturulduktan sonra geçerli düşük öncelikli fiyat maxPrice değerinin ötesine geçerse düşük öncelikli vm/VMSS çıkarmak için de kullanılır. Olası değerler şunlardır: sıfırdan büyük herhangi bir ondalık değer. Örnek: 0,01538. -1, düşük öncelikli VM/VMSS'nin fiyat nedeniyle çıkarılmaması gerektiğini gösterir. Ayrıca, sizin tarafınızdan sağlanmadıysa varsayılan en yüksek fiyat -1'dir.

Tür:Double
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-NoWait

İşlemi başlatır ve işlem tamamlanmadan hemen önce döndürür. İşlemin başarıyla tamamlandığını belirlemek için başka bir mekanizma kullanın.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-OsDiskWriteAccelerator

İşletim sistemi diskinde WriteAccelerator'ın etkinleştirilmesi veya devre dışı bırakılması gerekip gerekmediğini belirtir.

Tür:Boolean
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ProximityPlacementGroupId

Bu sanal makineyle kullanılacak Yakınlık Yerleştirme Grubunun kaynak kimliği.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ResourceGroupName

Sanal makinenin kaynak grubunun adını belirtir.

Tür:String
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-SecurityType

Sanal makinenin SecurityType değerini belirtir. UefiSettings'i etkinleştirmek için belirtilen herhangi bir değere ayarlanması gerekir. Varsayılan olarak, bu özellik ayarlanmadığı sürece UefiSettings etkinleştirilmez.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Tag

Kaynakların ve kaynak gruplarının bir dizi ad-değer çiftiyle etiketlenebilir olduğunu belirtir. Kaynaklara etiket eklemek, kaynakları kaynak grupları arasında birlikte gruplandırmanıza ve kendi görünümlerinizi oluşturmanıza olanak tanır. Her kaynakta ve kaynak grubunda en fazla 15 etiket bulunabilir.

Tür:Hashtable
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-UltraSSDEnabled

VM'de UltraSSD_LRS depolama hesabı türüne sahip bir veya daha fazla yönetilen veri diskine sahip bir özelliği etkinleştiren veya devre dışı bırakan bayrak. Depolama hesabı türü UltraSSD_LRS yönetilen diskler yalnızca bu özellik etkinse sanal makineye eklenebilir.

Tür:Boolean
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-UserData

Vm için UserData, base-64 kodlanmış olacaktır. Müşteri burada hiçbir gizli dizi geçirmemelidir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-vCPUCountAvailable

VM için kullanılabilen vCPU sayısını belirtir. Bu özellik istek gövdesinde belirtilmezse, varsayılan davranış bunu bir bölgedeki kullanılabilir tüm sanal makine boyutlarını listele api yanıtında gösterilen vm boyutu için kullanılabilir vCPU değerine ayarlamaktır.

Tür:Int32
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-vCPUCountPerCore

vCPU ile fiziksel çekirdek oranını belirtir. Bu özellik istek gövdesinde belirtilmediğinde, varsayılan davranış, bir bölgedeki tüm kullanılabilir sanal makine boyutlarını listele api yanıtında kullanıma sunulan VM Boyutu için vCPUsPerCore değerine ayarlanır. Bu özelliğin 1 olarak ayarlanması, hiper iş parçacığının devre dışı bırakıldığını da gösterir.

Tür:Int32
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-VirtualMachineScaleSetId

Sanal makinenin güncelleştirilmesi gereken Sanal Makine Ölçek Kümesi kimliği.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-VM

Yerel bir sanal makine nesnesi belirtir. Bir sanal makine nesnesi almak için Get-AzVM cmdlet'ini kullanın. Bu sanal makine nesnesi, sanal makine için güncelleştirilmiş durumu içerir.

Tür:PSVirtualMachine
Diğer adlar:VMProfile
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Tür:SwitchParameter
Diğer adlar:wi
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

String

PSVirtualMachine

Boolean

Çıkışlar

PSAzureOperationResponse