Add-AzVMDataDisk

Referens

Modul:: Az.Compute

Lägger till en datadisk till en virtuell dator.

Anteckning

Det här är den tidigare versionen av vår dokumentation. Se den senaste versionen för uppdaterad information.

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

Cmdleten Add-AzVMDataDisk lägger till en datadisk till en virtuell dator. Du kan lägga till en datadisk när du skapar en virtuell dator eller lägga till en datadisk till en befintlig virtuell dator.

Exempel

Exempel 1: Lägga till datadiskar till en ny virtuell dator

$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

Det första kommandot skapar ett virtuellt datorobjekt och lagrar det sedan i variabeln $VirtualMachine. Kommandot tilldelar ett namn och en storlek till den virtuella datorn. De följande tre kommandona tilldelar sökvägar för tre datadiskar till variablerna $DataDiskVhdUri 01, $DataDiskVhdUri 02 och $DataDiskVhdUri 03. Den här metoden är endast avsedd för läsbarhet för följande kommandon. De sista tre kommandona lägger var och en till en datadisk till den virtuella datorn som lagras i $VirtualMachine. Kommandot anger namn och plats för disken och andra egenskaper för disken. URI:n för varje disk lagras i $DataDiskVhdUri 01, $DataDiskVhdUri 02 och $DataDiskVhdUri 03.

Exempel 2: Lägga till en datadisk till en befintlig virtuell dator

$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

Det första kommandot hämtar den virtuella datorn med namnet VirtualMachine07 med hjälp av cmdleten Get-AzVM . Kommandot lagrar den virtuella datorn i variabeln $VirtualMachine. Det andra kommandot lägger till en datadisk till den virtuella datorn som lagras i $VirtualMachine. Det sista kommandot uppdaterar tillståndet för den virtuella datorn som lagras i $VirtualMachine i ResourceGroup11.

Exempel 3: Lägga till en datadisk till en ny virtuell dator från en generaliserad användarbild

$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

Det första kommandot skapar ett virtuellt datorobjekt och lagrar det i variabeln $VirtualMachine. Kommandot tilldelar ett namn och en storlek till den virtuella datorn. De följande två kommandona tilldelar sökvägar för databilden och datadiskarna till $DataImageUri respektive $DataDiskUri variabler. Den här metoden används för att förbättra läsbarheten för följande kommandon. De sista kommandona lägger till en datadisk till den virtuella datorn som lagras i $VirtualMachine. Kommandot anger namn och plats för disken och andra egenskaper för disken.

Exempel 4: Lägga till datadiskar till en ny virtuell dator från en specialiserad användarbild

$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

Det första kommandot skapar ett virtuellt datorobjekt och lagrar det i variabeln $VirtualMachine. Kommandot tilldelar ett namn och en storlek till den virtuella datorn. Nästa kommandon tilldelar sökvägar för datadisken till variabeln $DataDiskUri. Den här metoden används för att förbättra läsbarheten för följande kommandon. Det sista kommandot lägger till en datadisk till den virtuella datorn som lagras i $VirtualMachine. Kommandot anger namn och plats för disken och andra egenskaper för disken.

Parametrar

-Caching

Anger cachelagringsläget för disken. De acceptabla värdena för den här parametern är:

ReadOnly
ReadWrite
Ingen Standardvärdet är ReadWrite. Om du ändrar det här värdet startas den virtuella datorn om. Den här inställningen påverkar diskens konsekvens och prestanda.

Type:	CachingTypes
Accepted values:	None, ReadOnly, ReadWrite
Position:	3
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-CreateOption

Anger om den här cmdleten skapar en disk i den virtuella datorn från en plattforms- eller användarbild, skapar en tom disk eller kopplar en befintlig disk. De acceptabla värdena för den här parametern är:

Bifoga. Ange det här alternativet för att skapa en virtuell dator från en specialiserad disk. När du anger det här alternativet ska du inte ange parametern SourceImageUri . VhdUri är allt som behövs för att instruera Azure-plattformen att platsen för den virtuella hårddisken (VHD) ska anslutas som en datadisk till den virtuella datorn.
Tom. Ange detta för att skapa en tom datadisk.
FromImage. Ange det här alternativet för att skapa en virtuell dator från en generaliserad avbildning eller disk. När du anger det här alternativet måste du även ange parametern SourceImageUri för att kunna meddela Azure-plattformen var den virtuella hårddisken ska anslutas som en datadisk. VhdUri-parametern används som den plats som identifierar var datadiskens virtuella hårddisk ska lagras när den används av den virtuella datorn.

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

-DefaultProfile

Autentiseringsuppgifterna, kontot, klientorganisationen och prenumerationen som används för kommunikation med Azure.

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

-DeleteOption

Alternativet Ta bort datadisk. Anger vilken åtgärd som ska utföras på disken efter att den virtuella datorn har tagits bort. Alternativen är: Koppla från, Ta bort.

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

-DiskEncryptionSetId

Anger resurs-ID för kundens hanterade diskkrypteringsuppsättning. Detta kan endast anges för hanterad disk.

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

-DiskSizeInGB

Anger storleken i gigabyte på en tom disk som ska anslutas till en virtuell dator.

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

-Lun

Anger det logiska enhetsnumret (LUN) för en datadisk.

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

-ManagedDiskId

Anger ID för en hanterad disk.

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

-Name

Anger namnet på den datadisk som ska läggas till.

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

-SourceImageUri

Anger käll-URI:n för disken som denna cmdlet ansluter.

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

-StorageAccountType

Anger lagringskontotypen för den hanterade disken.

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

-VhdUri

Anger URI (Uniform Resource Identifier) för den virtuella hårddiskfilen (VHD) som ska skapas när en plattformsbild eller användarbild används. Den här cmdleten kopierar bildens binära stora objekt (blob) till den här platsen. Det här är den plats som den virtuella datorn ska startas från.

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

-VM

Anger det lokala virtuella datorobjekt som du vill lägga till en datadisk till. Du kan använda cmdleten Get-AzVM för att hämta ett virtuellt datorobjekt. Du kan använda cmdleten New-AzVMConfig för att skapa ett virtuellt datorobjekt.

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

-WriteAccelerator

Anger om WriteAccelerator ska aktiveras eller inaktiveras på en hanterad datadisk.

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

Indata

PSVirtualMachine

String

CachingTypes

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

Utdata