Dela via

Add-AzVMDataDisk

Modul:
Az.Compute Module

Lägger till en datadisk till en virtuell dator.

Syntax

VmNormalDiskParameterSetName (Standard) 

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

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>]
    [-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 godtagbara värdena för den här parametern är:

  • ReadOnly
  • Läs och skriv
  • 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.

Parameteregenskaper

Typ:CachingTypes
Standardvärde:None
Godkända värden:None, ReadOnly, ReadWrite
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:3
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument: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 godtagbara 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.
  • Empty. Ange detta för att skapa en tom datadisk.
  • FrånImage. 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.
  • Empty. Det här värdet används när du skapar en tom datadisk.
  • Kopia. Det här värdet används för att skapa en datadisk från en ögonblicksbild eller en annan disk. Återställ: Det här värdet används för att skapa en datadisk från en diskåterställningspunkt.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:6
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-DefaultProfile

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

Parameteregenskaper

Typ:IAzureContextContainer
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-DiskEncryptionSetId

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DiskSizeInGB

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

Parameteregenskaper

Typ:

Nullable<T>[Int32]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:4
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Lun

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

Parameteregenskaper

Typ:

Nullable<T>[Int32]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:5
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-ManagedDiskId

Anger ID för en hanterad disk.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

VmManagedDiskParameterSetName
Position:8
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Name

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:1
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-SourceImageUri

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:SourceImage

Parameteruppsättningar

VmNormalDiskParameterSetName
Position:7
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-SourceResourceId

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-StorageAccountType

Anger lagringskontotypen för hanterad disk.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

VmManagedDiskParameterSetName
Position:9
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument: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.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

VmNormalDiskParameterSetName
Position:2
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument: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.

Parameteregenskaper

Typ:PSVirtualMachine
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:VMProfile

Parameteruppsättningar

(All)
Position:0
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-WriteAccelerator

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

VmManagedDiskParameterSetName
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

PSVirtualMachine

String

CachingTypes

Nullable<T>

Utdata

PSVirtualMachine

PSVirtualMachineScaleSetVM