Sdílet prostřednictvím

Add-AzVMDataDisk

Modul:
Az.Compute Module

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

Syntax

VmNormalDiskParameterSetName (Výchozí) 

Add-AzVMDataDisk
    [-VM] <PSVirtualMachine>
    [[-Name] <String>]
    [[-VhdUri] <String>]
    [[-Caching] <CachingTypes>]
    [[-DiskSizeInGB] <Int32>]
    [-Lun] <Int32>
    [-CreateOption] <String>
    [[-SourceImageUri] <String>]
    [-DiskEncryptionSetId <String>]
    [-DeleteOption <String>]
    [-SourceResourceId <String>]
    [-DiskIOPSReadWrite <Int64>]
    [-DiskMBpsReadWrite <Int64>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

VmManagedDiskParameterSetName 

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>]
    [-DiskIOPSReadWrite <Int64>]
    [-DiskMBpsReadWrite <Int64>]
    [-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.

Příklad 5: Přidání datového disku UltraSSD s vlastním IOPS a propustností

$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_D2s_v3"
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name "UltraData1" -Lun 0 -CreateOption 'Empty' -DiskSizeInGB 10 -Caching 'None' -StorageAccountType 'UltraSSD_LRS' -DiskIOPSReadWrite 5000 -DiskMBpsReadWrite 200

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. Druhý příkaz přidá datový disk UltraSSD s vlastním IOPS (vstupně-výstupní operace za sekundu) nastaveným na 5000 a propustnost nastavenou na 200 MB za sekundu. Tyto parametry umožňují vyladění výkonu disku pro typy účtů úložiště UltraSSD_LRS a PremiumV2_LRS během implicitního vytváření disku.

Parametry

-Caching

Určuje režim ukládání do mezipaměti disku. Přijatelné hodnoty pro tento parametr jsou:

  • Jen pro čtení
  • Čtení a zápis
  • Žá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.

Vlastnosti parametru

Typ:CachingTypes
Default value:None
Přípustné hodnoty:None, ReadOnly, ReadWrite
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:3
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů: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 . Identifikátor VhdUri je vše potřebné 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.
  • Empty. 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 zadáte tuto možnost, je nutné zadat parametr SourceImageUri také, aby Azure platformě bylo 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.
  • Empty. 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.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:6
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-DefaultProfile

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

Vlastnosti parametru

Typ:IAzureContextContainer
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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í.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-DiskEncryptionSetId

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

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-DiskIOPSReadWrite

Určuje Read-Write IOPS (vstupně-výstupní operace za sekundu) disku, pokud je storageAccountType UltraSSD_LRS nebo PremiumV2_LRS.

Vlastnosti parametru

Typ:

Nullable<T>[Int64]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-DiskMBpsReadWrite

Určuje šířku pásma v MB za sekundu disku, pokud je storageAccountType UltraSSD_LRS nebo PremiumV2_LRS.

Vlastnosti parametru

Typ:

Nullable<T>[Int64]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-DiskSizeInGB

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

Vlastnosti parametru

Typ:

Nullable<T>[Int32]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:4
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-Lun

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

Vlastnosti parametru

Typ:

Nullable<T>[Int32]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:5
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-ManagedDiskId

Určuje ID spravovaného disku.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

VmManagedDiskParameterSetName
Position:8
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-Name

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

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-SourceImageUri

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

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:SourceImage

Sady parametrů

VmNormalDiskParameterSetName
Position:7
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-SourceResourceId

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

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-StorageAccountType

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

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

VmManagedDiskParameterSetName
Position:9
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů: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.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

VmNormalDiskParameterSetName
Position:2
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů: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 .

Vlastnosti parametru

Typ:PSVirtualMachine
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:VMProfile

Sady parametrů

(All)
Position:0
Povinné:True
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-WriteAccelerator

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

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

VmManagedDiskParameterSetName
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

PSVirtualMachine

String

CachingTypes

Nullable<T>

Výstupy

PSVirtualMachine

PSVirtualMachineScaleSetVM