Aracılığıyla paylaş

Add-AzVMDataDisk

  • Başvuru
Modül:
Az.Compute

Sanal makineye veri diski ekler.

Sözdizimi

Add-AzVMDataDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-VhdUri] <String>]
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-Lun] <Int32>
   [-CreateOption] <String>
   [[-SourceImageUri] <String>]
   [-DiskEncryptionSetId <String>]
   [-DeleteOption <String>]
   [-SourceResourceId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzVMDataDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-Lun] <Int32>
   [-CreateOption] <String>
   [[-ManagedDiskId] <String>]
   [[-StorageAccountType] <String>]
   [-DiskEncryptionSetId <String>]
   [-WriteAccelerator]
   [-DeleteOption <String>]
   [-SourceResourceId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Add-AzVMDataDisk cmdlet'i bir sanal makineye veri diski ekler. Sanal makine oluştururken veri diski ekleyebilir veya mevcut bir sanal makineye veri diski ekleyebilirsiniz.

Örnekler

Örnek 1: Yeni bir sanal makineye veri diskleri ekleme

$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
$DataDiskVhdUri01 = "https://contoso.blob.core.windows.net/test/data1.vhd"
$DataDiskVhdUri02 = "https://contoso.blob.core.windows.net/test/data2.vhd"
$DataDiskVhdUri03 = "https://contoso.blob.core.windows.net/test/data3.vhd"
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name 'DataDisk1' -Caching 'ReadOnly' -DiskSizeInGB 10 -Lun 0 -VhdUri $DataDiskVhdUri01 -CreateOption Empty
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name 'DataDisk2' -Caching 'ReadOnly' -DiskSizeInGB 11 -Lun 1 -VhdUri $DataDiskVhdUri02 -CreateOption Empty
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name 'DataDisk3' -Caching 'ReadOnly' -DiskSizeInGB 12 -Lun 2 -VhdUri $DataDiskVhdUri03 -CreateOption Empty

İlk komut bir sanal makine nesnesi oluşturur ve bunu $VirtualMachine değişkeninde depolar. komutu sanal makineye bir ad ve boyut atar. Sonraki üç komut $DataDiskVhdUri 01, $DataDiskVhdUri 02 ve $DataDiskVhdUri 03 değişkenlerine üç veri diskinin yolunu atar. Bu yaklaşım yalnızca aşağıdaki komutların okunabilirliği içindir. Son üç komut da $VirtualMachine depolanan sanal makineye bir veri diski ekler. komut, diskin adını ve konumunu ve diskin diğer özelliklerini belirtir. Her diskin URI'si $DataDiskVhdUri 01, $DataDiskVhdUri 02 ve $DataDiskVhdUri 03'te depolanır.

Örnek 2: Mevcut bir sanal makineye veri diski ekleme

$VirtualMachine = Get-AzVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07"
Add-AzVMDataDisk -VM $VirtualMachine -Name "disk1" -VhdUri "https://contoso.blob.core.windows.net/vhds/diskstandard03.vhd" -LUN 0 -Caching ReadOnly -DiskSizeinGB 1 -CreateOption Empty
Update-AzVM -ResourceGroupName "ResourceGroup11" -VM $VirtualMachine

İlk komut, Get-AzVM cmdlet'ini kullanarak VirtualMachine07 adlı sanal makineyi alır. komutu sanal makineyi $VirtualMachine değişkeninde depolar. İkinci komut, $VirtualMachine'de depolanan sanal makineye bir veri diski ekler. Son komut, ResourceGroup11'de $VirtualMachine depolanan sanal makinenin durumunu güncelleştirir.

Örnek 3: Genelleştirilmiş bir kullanıcı görüntüsünden yeni bir sanal makineye veri diski ekleme

$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
$DataImageUri = "https://contoso.blob.core.windows.net/system/Microsoft.Compute/Images/captured/dataimage.vhd"
$DataDiskUri = "https://contoso.blob.core.windows.net/test/datadisk.vhd"
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name "disk1" -SourceImageUri $DataImageUri -VhdUri $DataDiskUri -Lun 0 -DiskSizeinGB 10 -CreateOption FromImage

İlk komut bir sanal makine nesnesi oluşturur ve bunu $VirtualMachine değişkeninde depolar. komutu sanal makineye bir ad ve boyut atar. Sonraki iki komut, veri görüntüsü ve veri diskleri için sırasıyla $DataImageUri ve $DataDiskUri değişkenlerine yollar atar. Bu yaklaşım, aşağıdaki komutların okunabilirliğini geliştirmek için kullanılır. Son komutlar, $VirtualMachine depolanan sanal makineye bir veri diski ekler. komutu, diskin adını ve konumunu ve diskin diğer özelliklerini belirtir.

Örnek 4: Özel bir kullanıcı görüntüsünden yeni bir sanal makineye veri diskleri ekleme

$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
$DataDiskUri = "https://contoso.blob.core.windows.net/test/datadisk.vhd"
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name "dd1" -VhdUri $DataDiskUri -Lun 0 -DiskSizeinGB 10 -CreateOption Attach

İlk komut bir sanal makine nesnesi oluşturur ve bunu $VirtualMachine değişkeninde depolar. komutu sanal makineye bir ad ve boyut atar. Sonraki komutlar veri diskinin yollarını $DataDiskUri değişkenine atar. Bu yaklaşım, aşağıdaki komutların okunabilirliğini geliştirmek için kullanılır. Son komut, $VirtualMachine depolanan sanal makineye bir veri diski ekler. komut, diskin adını ve konumunu ve diskin diğer özelliklerini belirtir.

Parametreler

-Caching

Diskin önbelleğe alma modunu belirtir. Bu parametre için kabul edilebilir değerler şunlardır:

  • Salt Okunur
  • ReadWrite
  • Yok Varsayılan değer ReadWrite'dir. Bu değerin değiştirilmesi sanal makinenin yeniden başlatılmasına neden olur. Bu ayar, diskin tutarlılığını ve performansını etkiler.
Tür:CachingTypes
Kabul edilen değerler:None, ReadOnly, ReadWrite
Position:3
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-CreateOption

Bu cmdlet'in sanal makinede bir platformdan veya kullanıcı görüntüsünden disk oluşturup oluşturmadığını, boş disk oluşturup oluşturmadığını veya var olan bir diski ekleyip eklemediğini belirtir. Bu parametre için kabul edilebilir değerler şunlardır:

  • Takmak. Özelleştirilmiş bir diskten sanal makine oluşturmak için bu seçeneği belirtin. Bu seçeneği belirttiğinizde, SourceImageUri parametresini belirtmeyin. VhdUri, Azure platformuna sanal makineye veri diski olarak eklenecek sanal sabit diskin (VHD) konumunu bildirmek için gereken tek şey.
  • Boş. Boş bir veri diski oluşturmak için bunu belirtin.
  • FromImage. Genelleştirilmiş bir görüntüden veya diskten sanal makine oluşturmak için bu seçeneği belirtin. Bu seçeneği belirttiğinizde, Azure platformuna VHD'nin veri diski olarak ekleneceğini belirten SourceImageUri parametresini de belirtmeniz gerekir. VhdUri parametresi, sanal makine tarafından kullanıldığında veri diski VHD'sinin nerede depolandığını tanımlayan konum olarak kullanılır.
  • Boş. Bu değer boş bir veri diski oluştururken kullanılır.
  • Kopya etmek. Bu değer, anlık görüntüden veya başka bir diskten veri diski oluşturmak için kullanılır. Geri Yükleme: Bu değer, disk geri yükleme noktasından veri diski oluşturmak için kullanılır.
Tür:String
Position:6
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
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

-DeleteOption

Veri Diski Silme Seçeneği. VM silindikten sonra diskte gerçekleştirilecek eylemi belirtir. Seçenekler şunlardır: Ayır, Sil.

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

-DiskEncryptionSetId

Müşteri tarafından yönetilen disk şifreleme kümesinin kaynak kimliğini belirtir. Bu yalnızca yönetilen disk için belirtilebilir.

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

-DiskSizeInGB

Sanal makineye eklenecek boş diskin boyutunu gigabayt cinsinden belirtir.

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

-Lun

Veri diski için mantıksal birim numarasını (LUN) belirtir.

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

-ManagedDiskId

Yönetilen diskin kimliğini belirtir.

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

-Name

Eklenecek veri diskinin adını belirtir.

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

-SourceImageUri

Bu cmdlet'in ekli olduğu diskin kaynak URI'sini belirtir.

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

-SourceResourceId

Bir diskin oluşturulacağı anlık görüntünün veya disk geri yükleme noktasının ARM kimliği.

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

-StorageAccountType

Yönetilen diskin depolama hesabı türünü belirtir.

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

-VhdUri

Bir platform görüntüsü veya kullanıcı görüntüsü kullanıldığında oluşturulacak sanal sabit disk (VHD) dosyası için Tekdüzen Kaynak Tanımlayıcısı'nı (URI) belirtir. Bu cmdlet, görüntü ikili büyük nesnesini (blob) bu konuma kopyalar. Bu, sanal makinenin başlatıldığı konumdur.

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

-VM

Veri diskinin ekleneceği yerel sanal makine nesnesini belirtir. Sanal makine nesnesi almak için Get-AzVM cmdlet'ini kullanabilirsiniz. New-AzVMConfig cmdlet'ini kullanarak bir sanal makine nesnesi oluşturabilirsiniz.

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

-WriteAccelerator

Yönetilen bir veri diskinde WriteAccelerator'ın etkinleştirilmesi veya devre dışı bırakılması gerekip gerekmediğini belirtir.

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

Girişler

PSVirtualMachine

String

CachingTypes

Nullable<T>[[System.Int32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Çıkışlar

PSVirtualMachine

PSVirtualMachineScaleSetVM