Add-AzVMDataDisk
Adatlemez hozzáadása virtuális géphez.
Syntax
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
Az Add-AzVMDataDisk parancsmag adatlemezt ad hozzá egy virtuális géphez. A virtuális gép létrehozásakor adatlemezt adhat hozzá, vagy hozzáadhat egy adatlemezt egy meglévő virtuális géphez.
Példák
1. példa: Adatlemezek hozzáadása új virtuális géphez
$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
Az első parancs létrehoz egy virtuálisgép-objektumot, majd a $VirtualMachine változóban tárolja. A parancs nevet és méretet rendel a virtuális géphez. A következő három parancs három adatlemez elérési útját rendeli hozzá a $DataDiskVhdUri 01, $DataDiskVhdUri 02 és $DataDiskVhdUri 03 változókhoz. Ez a megközelítés csak a következő parancsok olvashatóságára vonatkozik. Az utolsó három parancs mindegyike hozzáad egy adatlemezt a $VirtualMachine tárolt virtuális géphez. A parancs megadja a lemez nevét és helyét, valamint a lemez egyéb tulajdonságait. Az egyes lemezek URI-ját $DataDiskVhdUri 01, $DataDiskVhdUri 02 és $DataDiskVhdUri 03 tárolja.
2. példa: Adatlemez hozzáadása meglévő virtuális géphez
$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
Az első parancs a Get-AzVM parancsmaggal lekéri a VirtualMachine07 nevű virtuális gépet. A parancs a virtuális gépet a $VirtualMachine változóban tárolja. A második parancs hozzáad egy adatlemezt a $VirtualMachine tárolt virtuális géphez. Az utolsó parancs frissíti a ResourceGroup11 $VirtualMachine-ben tárolt virtuális gép állapotát.
3. példa: Adatlemez hozzáadása új virtuális géphez általánosított felhasználói rendszerképből
$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
Az első parancs létrehoz egy virtuálisgép-objektumot, és a $VirtualMachine változóban tárolja. A parancs nevet és méretet rendel a virtuális géphez. A következő két parancs útvonalakat rendel az adatlemezekhez és az adatlemezekhez a $DataImageUri és $DataDiskUri változókhoz. Ez a módszer a következő parancsok olvashatóságának javítására szolgál. Az utolsó parancsok hozzáadnak egy adatlemezt a $VirtualMachine tárolt virtuális géphez. A parancs megadja a lemez nevét és helyét, valamint a lemez egyéb tulajdonságait.
4. példa: Adatlemezek hozzáadása egy új virtuális géphez egy speciális felhasználói rendszerképből
$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
Az első parancs létrehoz egy virtuálisgép-objektumot, és a $VirtualMachine változóban tárolja. A parancs nevet és méretet rendel a virtuális géphez. A következő parancsok az adatlemez elérési útjait rendelik hozzá a $DataDiskUri változóhoz. Ez a módszer a következő parancsok olvashatóságának javítására szolgál. Az utolsó parancs adatlemezt ad hozzá a $VirtualMachine tárolt virtuális géphez. A parancs megadja a lemez nevét és helyét, valamint a lemez egyéb tulajdonságait.
Paraméterek
-Caching
Megadja a lemez gyorsítótárazási módját. A paraméter elfogadható értékei a következők:
- Olvasás
- ReadWrite
- Nincs: Az alapértelmezett érték a ReadWrite. Az érték módosítása miatt a virtuális gép újraindul. Ez a beállítás hatással van a lemez konzisztenciájára és teljesítményére.
Típus: | CachingTypes |
Elfogadott értékek: | None, ReadOnly, ReadWrite |
Position: | 3 |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-CreateOption
Megadja, hogy ez a parancsmag létrehoz-e egy lemezt a virtuális gépen egy platformról vagy felhasználói lemezképből, létrehoz-e üres lemezt, vagy csatol-e egy meglévő lemezt. A paraméter elfogadható értékei a következők:
- Mellékel. Ezzel a beállítással speciális lemezről hozhat létre virtuális gépet. Ha ezt a beállítást adja meg, ne adja meg a SourceImageUri paramétert. A VhdUri minden, amire szükség van ahhoz, hogy az Azure-platformnak meg lehessen mondani a virtuális merevlemez (VHD) helyét, hogy adatlemezként csatolja a virtuális gépet.
- Üres. Adja meg ezt az üres adatlemez létrehozásához.
- FromImage. Ezzel a beállítással általánosított rendszerképből vagy lemezből hozhat létre virtuális gépet. Ha ezt a lehetőséget adja meg, meg kell adnia a SourceImageUri paramétert is, hogy az Azure-platformnak meg tudja adni a VHD helyét, hogy adatlemezként csatolja. A VhdUri paraméter a virtuális gép által használt adatlemez VHD-jének tárolási helyét azonosító helyként szolgál.
- Üres. Ez az érték üres adatlemez létrehozásakor használatos.
- Másolat. Ez az érték egy pillanatképből vagy egy másik lemezből származó adatlemez létrehozásához használható. Visszaállítás: Ez az érték egy lemez-visszaállítási pontból származó adatlemez létrehozásához használható.
Típus: | String |
Position: | 6 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-DefaultProfile
Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.
Típus: | IAzureContextContainer |
Aliasok: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-DeleteOption
Adatlemez törlése lehetőség. Megadja, hogy milyen műveletet kell végrehajtani a lemezen a virtuális gép törlése után. A beállítások a következők: Leválasztás, Törlés.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-DiskEncryptionSetId
Megadja az ügyfél által felügyelt lemeztitkosítási csoport erőforrás-azonosítóját. Ez csak felügyelt lemezhez adható meg.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-DiskSizeInGB
Megadja egy virtuális géphez csatolandó üres lemez méretét gigabájtban.
Típus: | Nullable<T>[Int32] |
Position: | 4 |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-Lun
Egy adatlemez logikai egységszámát (LUN) adja meg.
Típus: | Nullable<T>[Int32] |
Position: | 5 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-ManagedDiskId
Egy felügyelt lemez azonosítóját adja meg.
Típus: | String |
Position: | 8 |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-Name
Megadja a hozzáadni kívánt adatlemez nevét.
Típus: | String |
Position: | 1 |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-SourceImageUri
Megadja annak a lemeznek a forrás URI-ját, amelyet a parancsmag csatol.
Típus: | String |
Aliasok: | SourceImage |
Position: | 7 |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-SourceResourceId
A pillanatkép- vagy lemez-visszaállítási pont ARM-azonosítója, amelyből lemezt szeretne létrehozni.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-StorageAccountType
A felügyelt lemez tárfióktípusát adja meg.
Típus: | String |
Position: | 9 |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-VhdUri
Megadja a virtuális merevlemez -fájl (VHD) egységes erőforrás-azonosítóját (URI), amelyet platformrendszerkép vagy felhasználói rendszerkép használata esetén szeretne létrehozni. Ez a parancsmag a lemezkép bináris nagy objektumát (blobját) erre a helyre másolja. Innen indíthatja el a virtuális gépet.
Típus: | String |
Position: | 2 |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-VM
Megadja azt a helyi virtuálisgép-objektumot, amelyhez adatlemezt szeretne hozzáadni. A Get-AzVM parancsmaggal beszerezhet egy virtuálisgép-objektumot. A New-AzVMConfig parancsmaggal virtuálisgép-objektumot hozhat létre.
Típus: | PSVirtualMachine |
Aliasok: | VMProfile |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-WriteAccelerator
Megadja, hogy a WriteAccelerator engedélyezve legyen vagy le legyen tiltva egy felügyelt adatlemezen.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
Bevitelek
Nullable<T>[[System.Int32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]