Megosztás a következőn keresztül:

Add-AzureRmVMDataDisk

  • Referencia
Modul:
AzureRM.Compute

Adatlemezt ad hozzá egy virtuális géphez vagy virtuális géphez.

Figyelmeztetés

Az AzureRM PowerShell-modul 2024. február 29-én hivatalosan elavult. Javasoljuk a felhasználóknak, hogy migráljanak az AzureRM-ből az Az PowerShell-modulba a folyamatos támogatás és frissítések biztosítása érdekében.

Bár az AzureRM-modul továbbra is működik, a továbbiakban nem tart fenn vagy nem támogatott, így a folyamatos használatot a felhasználó saját belátása szerint és kockázatára teheti. Az Az modulra való áttéréshez tekintse meg a migrálási erőforrásainkat.

Syntax

Add-AzureRmVMDataDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-VhdUri] <String>]
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-Lun] <Int32>
   [-CreateOption] <String>
   [[-SourceImageUri] <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzureRmVMDataDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-Lun] <Int32>
   [-CreateOption] <String>
   [[-ManagedDiskId] <String>]
   [[-StorageAccountType] <String>]
   [-WriteAccelerator]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzureRmVMDataDisk
   [-VirtualMachineScaleSetVM] <PSVirtualMachineScaleSetVM>
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-Lun] <Int32>
   [-CreateOption] <String>
   [-ManagedDiskId] <String>
   [[-StorageAccountType] <String>]
   [-WriteAccelerator]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Az Add-AzureRmVMDataDisk parancsmag adatlemezt ad hozzá egy virtuális géphez vagy 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

PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
PS C:\> $DataDiskVhdUri01 = "https://contoso.blob.core.windows.net/test/data1.vhd"
PS C:\> $DataDiskVhdUri02 = "https://contoso.blob.core.windows.net/test/data2.vhd"
PS C:\> $DataDiskVhdUri03 = "https://contoso.blob.core.windows.net/test/data3.vhd"
PS C:\> $VirtualMachine = Add-AzureRmVMDataDisk -VM $VirtualMachine -Name 'DataDisk1' -Caching 'ReadOnly' -DiskSizeInGB 10 -Lun 0 -VhdUri $DataDiskVhdUri01 -CreateOption Empty
PS C:\> $VirtualMachine = Add-AzureRmVMDataDisk -VM $VirtualMachine -Name 'DataDisk2' -Caching 'ReadOnly' -DiskSizeInGB 11 -Lun 1 -VhdUri $DataDiskVhdUri02 -CreateOption Empty
PS C:\> $VirtualMachine = Add-AzureRmVMDataDisk -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

PS C:\> $VirtualMachine = Get-AzureRmVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07"
PS C:\> Add-AzureRmVMDataDisk -VM $VirtualMachine -Name "disk1" -VhdUri "https://contoso.blob.core.windows.net/vhds/diskstandard03.vhd" -LUN 0 -Caching ReadOnly -DiskSizeinGB 1 -CreateOption Empty
PS C:\> Update-AzureRmVM -ResourceGroupName "ResourceGroup11" -VM $VirtualMachine

Az első parancs a Get-AzureRmVM 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

PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
PS C:\> $DataImageUri = "https://contoso.blob.core.windows.net/system/Microsoft.Compute/Images/captured/dataimage.vhd"
PS C:\> $DataDiskUri = "https://contoso.blob.core.windows.net/test/datadisk.vhd"
PS C:\> $VirtualMachine = Add-AzureRmVMDataDisk -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

PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
PS C:\> $DataDiskUri = "https://contoso.blob.core.windows.net/test/datadisk.vhd"
PS C:\> $VirtualMachine = Add-AzureRmVMDataDisk -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.

5. példa: Felügyelt adatlemez hozzáadása virtuális gépekhez.

PS C:\> $disk = Get-AzureRmDisk -ResourceGroupName $rgname -DiskName $diskname0
PS C:\> $VmssVM = Get-AzureRmVmssVM -ResourceGroupName "myrg" -VMScaleSetName "myvmss" -InstanceId 0
PS C:\> $VmssVM = Add-AzureRmVMDataDisk -VirtualMachineScaleSetVM $VmssVM -Lun 0 -DiskSizeInGB 10 -CreateOption Attach -StorageAccountType Standard_LRS -ManagedDiskId $disk.Id
PS C:\> Update-AzureRmVmssVM -VirtualMachineScaleSetVM $VmssVM

Az első parancs lekéri a meglévő felügyelt lemezt. A következő parancs lekéri az erőforráscsoport neve, a virtuális gép neve és a példányazonosító által megadott meglévő virtuális gépek virtuális gépét. A következő parancs hozzáadja a felügyelt lemezt a helyileg $VmssVM tárolt virtuális gépekhez. Az utolsó parancs hozzáadott adatlemezzel frissíti a virtuális gépek virtuális gépét.

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:

  • 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.
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:AzureRmContext, AzureCredential
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ő:True
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

-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

-VirtualMachineScaleSetVM

Megadja azt a helyi virtuálisgép-méretezési csoport virtuálisgép-objektumot, amelyhez adatlemezt szeretne hozzáadni. A Get-AzureRmVmssVM parancsmaggal beszerezhet egy virtuálisgép-méretezési csoport virtuálisgép-objektumot.

Típus:PSVirtualMachineScaleSetVM
Position:0
Alapértelmezett érték:None
Kötelező:True
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-AzureRmVM parancsmaggal beszerezhet egy virtuálisgép-objektumot. A New-AzureRmVMConfig 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

PSVirtualMachine

PSVirtualMachineScaleSetVM

String

CachingTypes

Nullable<T>[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Kimenetek

PSVirtualMachine

PSVirtualMachineScaleSetVM