Add-AzVMDataDisk

  • Referens
Modul:
Az.Compute

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>]
   [-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

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.
Typ:CachingTypes
Godkända värden:None, ReadOnly, ReadWrite
Position:3
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken: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.
  • Tom. Det här värdet används när du skapar en tom datadisk.
  • Kopiera. Det här värdet används för att skapa en datadisk från en ögonblicksbild eller en annan disk. Återställning: Det här värdet används för att skapa en datadisk från en diskåterställningspunkt.
Typ:String
Position:6
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-DefaultProfile

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

Typ:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-DiskEncryptionSetId

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

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DiskSizeInGB

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

Typ:Nullable<T>[Int32]
Position:4
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Lun

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

Typ:Nullable<T>[Int32]
Position:5
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ManagedDiskId

Anger ID för en hanterad disk.

Typ:String
Position:8
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Name

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

Typ:String
Position:1
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-SourceImageUri

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

Typ:String
Alias:SourceImage
Position:7
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-SourceResourceId

ARM-ID för ögonblicksbild eller diskåterställningspunkt som du vill skapa en disk från.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-StorageAccountType

Anger lagringskontotypen för hanterad disk.

Typ:String
Position:9
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken: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.

Typ:String
Position:2
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken: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.

Typ:PSVirtualMachine
Alias:VMProfile
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WriteAccelerator

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

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

PSVirtualMachine

String

CachingTypes

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

Utdata

PSVirtualMachine

PSVirtualMachineScaleSetVM