Update-AzVM

Azure sanal makinesinin durumunu güncelleştirir.

Syntax

ResourceGroupNameParameterSetName (Varsayılan)

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

Update-AzVM cmdlet'i Azure sanal makinenin 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

-AlignRegionalDisksToVMZone

Bölgesel disklerin VM bölgesine hizalanıp hizalanmayacağını/taşınıp taşınmayacağını belirtir. Bu yalnızca yerleştirme özelliği ayarlanmış VM'ler için geçerlidir. Bu değişikliğin geri alınamayacağını lütfen unutmayın.

Parametre özellikleri

Tür:

Nullable<T>[Boolean]

Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-AsJob

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

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-CapacityReservationGroupId

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

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Confirm

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

Parametre özellikleri

Tür:SwitchParameter
Default value:False
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Cf

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-DefaultProfile

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

Parametre özellikleri

Tür:IAzureContextContainer
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:AzContext, AzureRmContext, AzureCredential

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-EnableSecureBoot

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

Parametre özellikleri

Tür:

Nullable<T>[Boolean]

Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-EnableVtpm

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

Parametre özellikleri

Tür:

Nullable<T>[Boolean]

Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer: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.

Parametre özellikleri

Tür:Boolean
Default value:False
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-HibernationEnabled

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

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-HostId

Ana Bilgisayarın Kimliği

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-Id

Sanal makinenin kaynak kimliğini belirtir.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

IdParameterSetName
Position:0
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer: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/identity/{identityName}'

Parametre özellikleri

Tür:

String[]

Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

ExplicitIdentityParameterSet
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-IdentityType

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

Parametre özellikleri

Tür:

Nullable<T>[ResourceIdentityType]

Default value:None
Kabul edilen değerler:SystemAssigned, UserAssigned, SystemAssignedUserAssigned, None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

ExplicitIdentityParameterSet
Position:Named
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer: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.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer: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.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer: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.

Parametre özellikleri

Tür:Double
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer: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.

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-OsDiskWriteAccelerator

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

Parametre özellikleri

Tür:Boolean
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-ProximityPlacementGroupId

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

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-ResourceGroupName

Sanal makinenin kaynak grubunun adını belirtir.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

ResourceGroupNameParameterSetName
Position:0
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False
ExplicitIdentityParameterSet
Position:0
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer: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.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer: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 kaynak veya kaynak grubu en fazla 15 etikete sahip olabilir.

Parametre özellikleri

Tür:Hashtable
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer: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.

Parametre özellikleri

Tür:Boolean
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-UserData

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

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-vCPUCountAvailable

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

Parametre özellikleri

Tür:Int32
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-vCPUCountPerCore

vCPU ile fiziksel çekirdek oranını belirtir. Bu özellik istek gövdesinde belirtilmediğinde, bir bölgedeki tüm kullanılabilir sanal makine boyutlarını listele api yanıtında gösterilen VM Boyutu için varsayılan davranış vCPUPerCore 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.

Parametre özellikleri

Tür:Int32
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-VirtualMachineScaleSetId

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

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer: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.

Parametre özellikleri

Tür:PSVirtualMachine
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:VMProfile

Parametre kümeleri

(All)
Position:Named
Zorunlu:True
İşlem hattından gelen değer:True
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-WhatIf

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

Parametre özellikleri

Tür:SwitchParameter
Default value:False
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Wi

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

String

PSVirtualMachine

Boolean

Çıkışlar

PSAzureOperationResponse