Sdílet prostřednictvím

Add-AzVMDataDisk

  • Reference
Modul:
Az.Compute

Přidá datový disk do virtuálního počítače.

Syntaxe

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

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. Přijatelné hodnoty pro tento parametr jsou:

  • 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.
Typ:CachingTypes
Přípustné hodnoty:None, ReadOnly, ReadWrite
Position:3
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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. Přijatelné hodnoty pro tento parametr jsou:

  • 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. VhdUri je vše, co je potřeba k tomu, aby platforma Azure řekla umístění virtuálního pevného disku (VHD) pro připojení jako datový disk k virtuálnímu počítači.
  • 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 určila 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.
  • Prázdný. Tato hodnota se používá při vytváření prázdného datového disku.
  • Kopírovat. Tato hodnota se používá k vytvoření datového disku ze snímku nebo jiného disku. Obnovení: Tato hodnota slouží k vytvoření datového disku z bodu obnovení disku.
Typ:String
Position:6
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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í.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-DiskEncryptionSetId

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

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DiskSizeInGB

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

Typ:Nullable<T>[Int32]
Position:4
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Lun

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

Typ:Nullable<T>[Int32]
Position:5
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ManagedDiskId

Určuje ID spravovaného disku.

Typ:String
Position:8
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

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

Typ:String
Position:1
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-SourceImageUri

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

Typ:String
Aliasy:SourceImage
Position:7
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-SourceResourceId

ID ARM bodu obnovení snímku nebo disku, ze kterého se má vytvořit disk.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-StorageAccountType

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

Typ:String
Position:9
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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.

Typ:String
Position:2
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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.

Typ:PSVirtualMachine
Aliasy:VMProfile
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WriteAccelerator

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

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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