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.

Type:	CachingTypes
Accepted values:	None, ReadOnly, ReadWrite
Position:	3
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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:

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

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

-DefaultProfile

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

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

-DeleteOption

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

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

-DiskEncryptionSetId

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

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

-DiskSizeInGB

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

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

-Lun

Menentukan nomor unit logis (LUN) untuk disk data.

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

-ManagedDiskId

Menentukan ID disk terkelola.

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

-Name

Menentukan nama disk data yang akan ditambahkan.

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

-SourceImageUri

Menentukan URI sumber disk yang dilampirkan cmdlet ini.

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

-StorageAccountType

Menentukan jenis akun penyimpanan disk terkelola.

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

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

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

-WriteAccelerator

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

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

Input

PSVirtualMachine

String

CachingTypes

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

Output