Add-AzVMDataDisk

  • Referencia
Modul:
Az.Compute

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

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

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

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

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

-DiskSizeInGB

Megadja egy virtuális géphez csatolandó üres lemez méretét gigabájtban.

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

-Lun

Egy adatlemez logikai egységszámát (LUN) adja meg.

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

-ManagedDiskId

Egy felügyelt lemez azonosítóját adja meg.

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

-Name

Megadja a hozzáadni kívánt adatlemez nevét.

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

-SourceImageUri

Megadja annak a lemeznek a forrás URI-ját, amelyet a parancsmag csatol.

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

-StorageAccountType

A felügyelt lemez tárfióktípusát adja meg.

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

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

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

-WriteAccelerator

Megadja, hogy a WriteAccelerator engedélyezve legyen vagy le legyen tiltva egy felügyelt adatlemezen.

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

Bevitelek

PSVirtualMachine

String

CachingTypes

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

Kimenetek

PSVirtualMachine

PSVirtualMachineScaleSetVM