Add-AzVMDataDisk

Sanal makineye veri diski ekler.

Syntax

Add-AzVMDataDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-VhdUri] <String>]
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-Lun] <Int32>
   [-CreateOption] <String>
   [[-SourceImageUri] <String>]
   [-DiskEncryptionSetId <String>]
   [-DeleteOption <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>]
   [-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 parametrenin kabul edilebilir değerleri ş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.
Type:CachingTypes
Accepted values:None, ReadOnly, ReadWrite
Position:3
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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 parametrenin kabul edilebilir değerleri şunlardır:

  • Eklemek. Ö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 şeydir.
  • 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 belirtmek için SourceImageUri parametresini de belirtmeniz gerekir. VhdUri parametresi, sanal makine tarafından kullanıldığında veri diski VHD'sinin depolanacağı konumu tanımlayan konum olarak kullanılır.
Type:String
Position:6
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeleteOption

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DiskSizeInGB

Sanal makineye eklenecek boş diskin boyutunu gigabayt cinsinden belirtir.

Type:Nullable<T>[Int32]
Position:4
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Lun

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

Type:Nullable<T>[Int32]
Position:5
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ManagedDiskId

Yönetilen diskin kimliğini belirtir.

Type:String
Position:8
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Eklenecek veri diskinin adını belirtir.

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SourceImageUri

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

Type:String
Aliases:SourceImage
Position:7
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-StorageAccountType

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

Type:String
Position:9
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Position:2
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-VM

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

Type:PSVirtualMachine
Aliases:VMProfile
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WriteAccelerator

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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