Share via

Add-AzVMDataDisk

  • Reference
Modul:
Az.Compute

Přidá datový disk k virtuálnímu počítači.

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

Rutina Add-AzVMDataDisk přidá datový disk do virtuálního počítače. Datový disk můžete přidat při vytváření virtuálního počítače nebo můžete přidat datový disk do existujícího virtuálního počítače.

Příklady

Příklad 1: Přidání datových disků do nového virtuálního počítače

$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

První příkaz vytvoří objekt virtuálního počítače a pak ho uloží do proměnné $VirtualMachine. Příkaz přiřadí virtuálnímu počítači název a velikost. Následující tři příkazy přiřazují cesty tří datových disků k proměnným $DataDiskVhdUri 01, $DataDiskVhdUri 02 a $DataDiskVhdUri 03. Tento přístup je určen pouze pro čitelnost následujících příkazů. Poslední tři příkazy každý přidá datový disk do virtuálního počítače uloženého v $VirtualMachine. Příkaz určuje název a umístění disku a další vlastnosti disku. Identifikátor URI každého disku je uložený v $DataDiskVhdUri 01, $DataDiskVhdUri 02 a $DataDiskVhdUri 03.

Příklad 2: Přidání datového disku do existujícího virtuálního počítače

$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

První příkaz získá virtuální počítač s názvem VirtualMachine07 pomocí rutiny Get-AzVM . Příkaz uloží virtuální počítač do proměnné $VirtualMachine. Druhý příkaz přidá datový disk do virtuálního počítače uloženého v $VirtualMachine. Poslední příkaz aktualizuje stav virtuálního počítače uloženého v $VirtualMachine v ResourceGroup11.

Příklad 3: Přidání datového disku do nového virtuálního počítače z generalizované image uživatele

$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

První příkaz vytvoří objekt virtuálního počítače a uloží ho do proměnné $VirtualMachine. Příkaz přiřadí virtuálnímu počítači název a velikost. Následující dva příkazy přiřazují cesty k datové imagi a datovým diskům $DataImageUri a $DataDiskUri proměnným. Tento přístup se používá ke zlepšení čitelnosti následujících příkazů. Poslední příkazy přidají datový disk do virtuálního počítače uloženého v $VirtualMachine. Příkaz určuje název a umístění disku a další vlastnosti disku.

Příklad 4: Přidání datových disků do nového virtuálního počítače ze specializované image uživatele

$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

První příkaz vytvoří objekt virtuálního počítače a uloží ho do proměnné $VirtualMachine. Příkaz přiřadí virtuálnímu počítači název a velikost. Další příkazy přiřazují cesty datového disku k proměnné $DataDiskUri. Tento přístup se používá ke zlepšení čitelnosti následujících příkazů. Poslední příkaz přidá datový disk do virtuálního počítače uloženého v $VirtualMachine. Příkaz určuje název a umístění disku a další vlastnosti disku.

Parametry

-Caching

Určuje režim ukládání do mezipaměti disku. Tento parametr přijímá tyto hodnoty:

  • Jen pro čtení
  • Readwrite
  • Žádná Výchozí hodnota je ReadWrite. Změna této hodnoty způsobí restartování virtuálního počítače. Toto nastavení má vliv na konzistenci a výkon disku.
Type:CachingTypes
Accepted values:None, ReadOnly, ReadWrite
Position:3
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-CreateOption

Určuje, jestli tato rutina vytvoří na virtuálním počítači disk z image platformy nebo uživatele, vytvoří prázdný disk nebo připojí existující disk. Tento parametr přijímá tyto hodnoty:

  • Připojit. Tuto možnost zadejte, pokud chcete vytvořit virtuální počítač ze specializovaného disku. Při zadání této možnosti nezadávejte parametr SourceImageUri . Identifikátor VhdUri je vše, co je potřeba k tomu, aby platformě Azure řekl umístění virtuálního pevného disku (VHD), aby se k virtuálnímu počítači připojil jako datový disk.
  • Prázdné. Tuto možnost zadejte, pokud chcete vytvořit prázdný datový disk.
  • ZImage. Tuto možnost zadejte, pokud chcete vytvořit virtuální počítač z generalizované image nebo disku. Pokud tuto možnost zadáte, musíte zadat také parametr SourceImageUri , aby platforma Azure řekla umístění virtuálního pevného disku, který se má připojit jako datový disk. Parametr VhdUri se používá jako umístění určující, kam se datový disk VHD uloží při jeho použití virtuálním počítačem.
Type:String
Position:6
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

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

-DeleteOption

Možnost odstranění datového disku Určuje, jaká akce se má na disku provést po odstranění virtuálního počítače. Možnosti jsou: Odpojení, odstranění.

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

-DiskEncryptionSetId

Určuje ID prostředku sady šifrování disků spravované zákazníkem. Dá se zadat jenom pro spravovaný disk.

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

-DiskSizeInGB

Určuje velikost prázdného disku v gigabajtech, který se má připojit k virtuálnímu počítači.

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

-Lun

Určuje číslo logické jednotky (LUN) datového disku.

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

-ManagedDiskId

Určuje ID spravovaného disku.

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

-Name

Určuje název datového disku, který chcete přidat.

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

-SourceImageUri

Určuje zdrojový identifikátor URI disku, který tato rutina připojí.

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

-StorageAccountType

Určuje typ účtu úložiště spravovaného disku.

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

-VhdUri

Určuje identifikátor URI (Uniform Resource Identifier) pro soubor virtuálního pevného disku (VHD), který se má vytvořit při použití image platformy nebo image uživatele. Tato rutina zkopíruje do tohoto umístění binární objekt binárního velkého objektu (objekt blob). Toto je umístění, ze kterého se má virtuální počítač spustit.

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

-VM

Určuje objekt místního virtuálního počítače, do kterého se má přidat datový disk. K získání objektu virtuálního počítače můžete použít rutinu Get-AzVM . K vytvoření objektu virtuálního počítače můžete použít rutinu New-AzVMConfig .

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

-WriteAccelerator

Určuje, jestli má být na spravovaném datovém disku povolený nebo zakázaný WriteAccelerator.

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

Vstupy

PSVirtualMachine

String

CachingTypes

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

Výstupy

PSVirtualMachine

PSVirtualMachineScaleSetVM