Add-AzVMDataDisk

Lägger till en datadisk till en virtuell dator.

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 så kan du 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:

  • Skrivskyddat
  • Skriv upp
  • 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
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-CreateOption

Anger om den här cmdleten skapar en disk på den virtuella datorn från en plattform 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 ge Azure-plattformen platsen för den virtuella hårddisken (VHD) att ansluta 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 tala om för Azure-plattformen var den virtuella hårddisken ska anslutas som en datadisk. VhdUri-parametern används som den plats där den virtuella hårddisken för datadisken lagras när den används av den virtuella datorn.
Type:String
Position:6
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
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
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DiskEncryptionSetId

Anger resurs-ID för kundhanterad diskkrypteringsuppsättning. Detta kan bara anges för hanterad disk.

Type:String
Position:Named
Default value:None
Required:False
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
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Lun

Anger LUN (Logical Unit Number) för en datadisk.

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

-ManagedDiskId

Anger ID för en hanterad disk.

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

-Name

Anger namnet på datadisken som ska läggas till.

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

-SourceImageUri

Anger käll-URI:n för disken som den här cmdleten ansluter.

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

-StorageAccountType

Anger lagringskontotypen för hanterad disk.

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

-VhdUri

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

Type:String
Position:2
Default value:None
Required:False
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 Get-AzVM-cmdleten 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
Required:True
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
Required:False
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

PSVirtualMachine

PSVirtualMachineScaleSetVM