Add-AzVMDataDisk

Modul:

Az.Compute Module

Menambahkan disk data ke komputer virtual.

Sintaks

VmNormalDiskParameterSetName (Default)

Add-AzVMDataDisk
    [-VM] <PSVirtualMachine>
    [[-Name] <String>]
    [[-VhdUri] <String>]
    [[-Caching] <CachingTypes>]
    [[-DiskSizeInGB] <Int32>]
    [-Lun] <Int32>
    [-CreateOption] <String>
    [[-SourceImageUri] <String>]
    [-DiskEncryptionSetId <String>]
    [-DeleteOption <String>]
    [-SourceResourceId <String>]
    [-DiskIOPSReadWrite <Int64>]
    [-DiskMBpsReadWrite <Int64>]
    [-StorageFaultDomainAlignment <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

VmManagedDiskParameterSetName

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>]
    [-DiskIOPSReadWrite <Int64>]
    [-DiskMBpsReadWrite <Int64>]
    [-StorageFaultDomainAlignment <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.

Contoh 5: Menambahkan disk data UltraSSD dengan IOPS dan throughput kustom

$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_D2s_v3"
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name "UltraData1" -Lun 0 -CreateOption 'Empty' -DiskSizeInGB 10 -Caching 'None' -StorageAccountType 'UltraSSD_LRS' -DiskIOPSReadWrite 5000 -DiskMBpsReadWrite 200

Perintah pertama membuat objek komputer virtual dan menyimpannya dalam variabel $VirtualMachine. Perintah menetapkan nama dan ukuran ke komputer virtual. Perintah kedua menambahkan disk data UltraSSD dengan IOPS kustom (Operasi Input/Output Per Detik) yang diatur ke 5000 dan throughput diatur ke 200 MB per detik. Parameter ini memungkinkan penyempurnaan performa disk untuk jenis akun penyimpanan UltraSSD_LRS dan PremiumV2_LRS selama pembuatan disk implisit.

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.

Properti parameter

Jenis:	CachingTypes
Nilai default:	None
Nilai yang diterima:	None, ReadOnly, ReadWrite
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	3
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	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.
• Empty. Tentukan ini untuk membuat disk data kosong.
• DariGambar. 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.
• Empty. Nilai ini digunakan saat membuat disk data kosong.
• Salin. Nilai ini digunakan untuk membuat disk data dari rekam jepret atau disk lain. Pulihkan: Nilai ini digunakan untuk membuat disk data dari titik pemulihan disk.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	6
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-DefaultProfile

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

Properti parameter

Jenis:	IAzureContextContainer
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	AzContext, AzureRmContext, AzureCredential

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-DeleteOption

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

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-DiskEncryptionSetId

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

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-DiskIOPSReadWrite

Menentukan IOPS Read-Write (Operasi Input/Output Per Detik) untuk disk saat StorageAccountType UltraSSD_LRS atau PremiumV2_LRS.

Properti parameter

Jenis:	Nullable<T>[Int64]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-DiskMBpsReadWrite

Menentukan bandwidth dalam MB per detik untuk disk saat StorageAccountType UltraSSD_LRS atau PremiumV2_LRS.

Properti parameter

Jenis:	Nullable<T>[Int64]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-DiskSizeInGB

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

Properti parameter

Jenis:	Nullable<T>[Int32]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	4
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-Lun

Menentukan nomor unit logis (LUN) untuk disk data.

Properti parameter

Jenis:	Nullable<T>[Int32]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	5
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-ManagedDiskId

Menentukan ID disk terkelola.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

VmManagedDiskParameterSetName

Position:	8
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-Name

Menentukan nama disk data yang akan ditambahkan.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	1
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-SourceImageUri

Menentukan URI sumber disk yang dilampirkan cmdlet ini.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	SourceImage

Kumpulan parameter

VmNormalDiskParameterSetName

Position:	7
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-SourceResourceId

ID ARM rekam jepret atau titik pemulihan disk untuk membuat disk.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-StorageAccountType

Menentukan jenis akun penyimpanan disk terkelola.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

VmManagedDiskParameterSetName

Position:	9
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-StorageFaultDomainAlignment

Menentukan jenis perataan domain kesalahan penyimpanan untuk disk data. Nilai yang valid adalah 'Diselaraskan' dan 'BestEffortAligned'. 'Selaras' memetakan Domain Kesalahan Penyimpanan disk ke Domain Kesalahan Komputasi; penyebaran gagal jika disk tidak mendukung FD yang cukup. Upaya pemetaan 'BestEffortAligned' tetapi membiarkan disk tidak ditandatangani jika tidak mendukung FD yang cukup. Hanya berlaku untuk VM dalam VMSS Flex; CRP mengembalikan BadRequest untuk VM mandiri.

Properti parameter

Jenis:	String
Nilai default:	None
Nilai yang diterima:	Aligned, BestEffortAligned
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

VmNormalDiskParameterSetName

Position:	2
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	PSVirtualMachine
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	VMProfile

Kumpulan parameter

(All)

Position:	0
Wajib:	True
Nilai dari alur:	True
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-WriteAccelerator

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

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

VmManagedDiskParameterSetName

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

PSVirtualMachine

String

CachingTypes

Nullable<T>

Output

PSVirtualMachine

PSVirtualMachineScaleSetVM

Link Terkait

• Remove-AzVMDataDisk
• Get-AzVM
• New-AzVMConfig