Bagikan melalui

Add-AzVMDataDisk

  • Referensi
Modul:
Az.Compute

Menambahkan disk data ke komputer virtual.

Sintaks

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>]

Deskripsi

Cmdlet Add-AzVMDataDisk menambahkan disk data ke komputer virtual. Anda dapat menambahkan disk data saat membuat komputer virtual, atau Anda dapat menambahkan disk data ke komputer virtual yang ada.

Contoh

Contoh 1: Menambahkan disk data ke komputer virtual baru

$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

Perintah pertama membuat objek komputer virtual, lalu menyimpannya dalam variabel $VirtualMachine. Perintah menetapkan nama dan ukuran ke komputer virtual. Tiga perintah berikutnya menetapkan jalur tiga disk data ke variabel $DataDiskVhdUri 01, $DataDiskVhdUri 02, dan $DataDiskVhdUri 03. Pendekatan ini hanya untuk keterbacaan perintah berikut. Tiga perintah terakhir masing-masing menambahkan disk data ke komputer virtual yang disimpan dalam $VirtualMachine. Perintah menentukan nama dan lokasi untuk disk, dan properti disk lainnya. URI setiap disk disimpan di $DataDiskVhdUri 01, $DataDiskVhdUri 02, dan $DataDiskVhdUri 03.

Contoh 2: Menambahkan disk data ke komputer virtual yang ada

$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

Perintah pertama mendapatkan komputer virtual bernama VirtualMachine07 dengan menggunakan cmdlet Get-AzVM . Perintah menyimpan komputer virtual dalam variabel $VirtualMachine. Perintah kedua menambahkan disk data ke komputer virtual yang disimpan di $VirtualMachine. Perintah akhir memperbarui status komputer virtual yang disimpan di $VirtualMachine di ResourceGroup11.

Contoh 3: Menambahkan disk data ke komputer virtual baru dari gambar pengguna umum

$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

Perintah pertama membuat objek komputer virtual dan menyimpannya dalam variabel $VirtualMachine. Perintah menetapkan nama dan ukuran ke komputer virtual. Dua perintah berikutnya menetapkan jalur untuk gambar data dan disk data ke variabel $DataImageUri dan $DataDiskUri masing-masing. Pendekatan ini digunakan untuk meningkatkan keterbacaan perintah berikut. Perintah akhir menambahkan disk data ke komputer virtual yang disimpan di $VirtualMachine. Perintah menentukan nama dan lokasi untuk disk dan properti disk lainnya.

Contoh 4: Menambahkan disk data ke komputer virtual baru dari gambar pengguna khusus

$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

Perintah pertama membuat objek komputer virtual dan menyimpannya dalam variabel $VirtualMachine. Perintah menetapkan nama dan ukuran ke komputer virtual. Perintah berikutnya menetapkan jalur disk data ke variabel $DataDiskUri. Pendekatan ini digunakan untuk meningkatkan keterbacaan perintah berikut. Perintah akhir menambahkan disk data ke komputer virtual yang disimpan di $VirtualMachine. Perintah menentukan nama dan lokasi untuk disk, dan properti disk lainnya.

Parameter

-Caching

Menentukan mode penembolokan disk. Nilai yang dapat diterima untuk parameter ini adalah:

  • Baca Saja
  • ReadWrite
  • Tidak Ada Nilai defaultnya adalah ReadWrite. Mengubah nilai ini menyebabkan komputer virtual dimulai ulang. Pengaturan ini memengaruhi konsistensi dan performa disk.
Jenis:CachingTypes
Nilai yang diterima:None, ReadOnly, ReadWrite
Position:3
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-CreateOption

Menentukan apakah cmdlet ini membuat disk di komputer virtual dari platform atau gambar pengguna, membuat disk kosong, atau melampirkan disk yang ada. Nilai yang dapat diterima untuk parameter ini adalah:

  • Memasang. Tentukan opsi ini untuk membuat komputer virtual dari disk khusus. Saat Anda menentukan opsi ini, jangan tentukan parameter SourceImageUri . VhdUri adalah semua yang diperlukan untuk memberi tahu platform Azure lokasi hard disk virtual (VHD) untuk dilampirkan sebagai disk data ke komputer virtual.
  • Kosong. Tentukan ini untuk membuat disk data kosong.
  • FromImage. Tentukan opsi ini untuk membuat komputer virtual dari gambar atau disk umum. Saat menentukan opsi ini, Anda harus menentukan parameter SourceImageUri juga untuk memberi tahu platform Azure lokasi VHD untuk dilampirkan sebagai disk data. Parameter VhdUri digunakan sebagai lokasi yang mengidentifikasi tempat VHD disk data akan disimpan saat digunakan oleh komputer virtual.
Jenis:String
Position:6
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan azure.

Jenis:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-DeleteOption

Opsi Hapus Disk Data. Menentukan tindakan apa yang harus dilakukan pada disk setelah penghapusan VM. Opsinya adalah: Lepaskan, Hapus.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-DiskEncryptionSetId

Menentukan ID sumber daya set enkripsi disk yang dikelola pelanggan. Ini hanya dapat ditentukan untuk disk terkelola.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-DiskSizeInGB

Menentukan ukuran, dalam gigabyte, dari disk kosong untuk dilampirkan ke komputer virtual.

Jenis:Nullable<T>[Int32]
Position:4
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-Lun

Menentukan nomor unit logis (LUN) untuk disk data.

Jenis:Nullable<T>[Int32]
Position:5
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-ManagedDiskId

Menentukan ID disk terkelola.

Jenis:String
Position:8
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-Name

Menentukan nama disk data yang akan ditambahkan.

Jenis:String
Position:1
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-SourceImageUri

Menentukan URI sumber disk yang dilampirkan cmdlet ini.

Jenis:String
Alias:SourceImage
Position:7
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-StorageAccountType

Menentukan jenis akun penyimpanan disk terkelola.

Jenis:String
Position:9
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-VhdUri

Menentukan Pengidentifikasi Sumber Daya Seragam (URI) untuk file hard disk virtual (VHD) untuk dibuat saat gambar platform atau gambar pengguna digunakan. Cmdlet ini menyalin objek besar biner gambar (blob) ke lokasi ini. Ini adalah lokasi untuk memulai komputer virtual.

Jenis:String
Position:2
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-VM

Menentukan objek komputer virtual lokal untuk menambahkan disk data. Anda dapat menggunakan cmdlet Get-AzVM untuk mendapatkan objek komputer virtual. Anda dapat menggunakan cmdlet New-AzVMConfig untuk membuat objek komputer virtual.

Jenis:PSVirtualMachine
Alias:VMProfile
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-WriteAccelerator

Menentukan apakah WriteAccelerator harus diaktifkan atau dinonaktifkan pada disk data terkelola.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

Input

PSVirtualMachine

String

CachingTypes

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

Output

PSVirtualMachine

PSVirtualMachineScaleSetVM