Delen via


Add-AzVMDataDisk

Hiermee voegt u een gegevensschijf toe aan een virtuele machine.

Syntax

VmNormalDiskParameterSetName (Standaard)

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

De cmdlet Add-AzVMDataDisk voegt een gegevensschijf toe aan een virtuele machine. U kunt een gegevensschijf toevoegen wanneer u een virtuele machine maakt of u kunt een gegevensschijf toevoegen aan een bestaande virtuele machine.

Voorbeelden

Voorbeeld 1: Gegevensschijven toevoegen aan een nieuwe virtuele machine

$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

Met de eerste opdracht wordt een virtuele-machineobject gemaakt en vervolgens opgeslagen in de $VirtualMachine variabele. Met de opdracht wordt een naam en grootte toegewezen aan de virtuele machine. Met de volgende drie opdrachten worden paden van drie gegevensschijven toegewezen aan de variabelen $DataDiskVhdUri 01, $DataDiskVhdUri 02 en $DataDiskVhdUri 03. Deze methode is alleen geschikt voor leesbaarheid van de volgende opdrachten. Met de laatste drie opdrachten wordt elk een gegevensschijf toegevoegd aan de virtuele machine die is opgeslagen in $VirtualMachine. Met de opdracht geeft u de naam en locatie voor de schijf en andere eigenschappen van de schijf op. De URI van elke schijf wordt opgeslagen in $DataDiskVhdUri 01, $DataDiskVhdUri 02 en $DataDiskVhdUri 03.

Voorbeeld 2: Een gegevensschijf toevoegen aan een bestaande virtuele machine

$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

Met de eerste opdracht wordt de virtuele machine met de naam VirtualMachine07 opgehaald met behulp van de Cmdlet Get-AzVM . Met de opdracht wordt de virtuele machine opgeslagen in de variabele $VirtualMachine. Met de tweede opdracht wordt een gegevensschijf toegevoegd aan de virtuele machine die is opgeslagen in $VirtualMachine. Met de laatste opdracht wordt de status bijgewerkt van de virtuele machine die is opgeslagen in $VirtualMachine in ResourceGroup11.

Voorbeeld 3: Een gegevensschijf toevoegen aan een nieuwe virtuele machine vanuit een gegeneraliseerde gebruikersinstallatiekopieën

$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

Met de eerste opdracht wordt een virtuele-machineobject gemaakt en opgeslagen in de $VirtualMachine variabele. Met de opdracht wordt een naam en grootte toegewezen aan de virtuele machine. Met de volgende twee opdrachten worden paden voor de gegevensinstallatiekopieën en gegevensschijven toegewezen aan respectievelijk de $DataImageUri en $DataDiskUri variabelen. Deze methode wordt gebruikt om de leesbaarheid van de volgende opdrachten te verbeteren. Met de laatste opdrachten wordt een gegevensschijf toegevoegd aan de virtuele machine die is opgeslagen in $VirtualMachine. De opdracht geeft de naam en locatie voor de schijf en andere eigenschappen van de schijf.

Voorbeeld 4: Gegevensschijven toevoegen aan een nieuwe virtuele machine vanuit een gespecialiseerde gebruikersinstallatiekopieën

$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

Met de eerste opdracht wordt een virtuele-machineobject gemaakt en opgeslagen in de $VirtualMachine variabele. Met de opdracht wordt een naam en grootte toegewezen aan de virtuele machine. Met de volgende opdrachten worden paden van de gegevensschijf toegewezen aan de $DataDiskUri variabele. Deze methode wordt gebruikt om de leesbaarheid van de volgende opdrachten te verbeteren. Met de laatste opdracht voegt u een gegevensschijf toe aan de virtuele machine die is opgeslagen in $VirtualMachine. Met de opdracht geeft u de naam en locatie voor de schijf en andere eigenschappen van de schijf op.

Parameters

-Caching

Hiermee geeft u de cachemodus van de schijf. De acceptabele waarden voor deze parameter zijn:

  • ReadOnly
  • LezenSchrijven
  • Geen De standaardwaarde is ReadWrite. Als u deze waarde wijzigt, wordt de virtuele machine opnieuw opgestart. Deze instelling is van invloed op de consistentie en prestaties van de schijf.

Parametereigenschappen

Type:CachingTypes
Default value:None
Geaccepteerde waarden:None, ReadOnly, ReadWrite
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:3
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-CreateOption

Hiermee geeft u op of met deze cmdlet een schijf in de virtuele machine wordt gemaakt op basis van een platform- of gebruikersinstallatiekopieën, een lege schijf wordt gemaakt of een bestaande schijf wordt gekoppeld. De acceptabele waarden voor deze parameter zijn:

  • Vastmaken. Geef deze optie op om een virtuele machine te maken op basis van een gespecialiseerde schijf. Wanneer u deze optie opgeeft, moet u de parameter SourceImageUri niet opgeven. De VhdUri is alles wat nodig is om het Azure-platform de locatie van de virtuele harde schijf (VHD) te laten koppelen als een gegevensschijf aan de virtuele machine.
  • Empty. Geef dit op om een lege gegevensschijf te maken.
  • Van afbeelding. Geef deze optie op om een virtuele machine te maken op basis van een gegeneraliseerde installatiekopieën of schijf. Wanneer u deze optie opgeeft, moet u ook de parameter SourceImageUri opgeven om het Azure-platform de locatie van de VHD te laten koppelen als een gegevensschijf. De parameter VhdUri wordt gebruikt als de locatie waar de VHD van de gegevensschijf wordt opgeslagen wanneer deze door de virtuele machine wordt gebruikt.
  • Empty. Deze waarde wordt gebruikt bij het maken van een lege gegevensschijf.
  • Kopiëren. Deze waarde wordt gebruikt om een gegevensschijf te maken op basis van een momentopname of een andere schijf. Herstellen: Deze waarde wordt gebruikt om een gegevensschijf te maken vanaf een schijfherstelpunt.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:6
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Parametereigenschappen

Type:IAzureContextContainer
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AzContext, AzureRmContext, AzureCredential

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DeleteOption

Optie voor verwijderen van gegevensschijf. Hiermee geeft u op welke actie moet worden uitgevoerd op de schijf nadat de VM is verwijderd. Opties zijn: Loskoppelen, Verwijderen.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-DiskEncryptionSetId

Hiermee geeft u de resource-id van de door de klant beheerde schijfversleutelingsset op. Dit kan alleen worden opgegeven voor beheerde schijf.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DiskSizeInGB

Hiermee geeft u de grootte, in gigabytes, van een lege schijf die aan een virtuele machine moet worden gekoppeld.

Parametereigenschappen

Type:

Nullable<T>[Int32]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:4
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Lun

Hiermee geeft u het lun (Logical Unit Number) voor een gegevensschijf op.

Parametereigenschappen

Type:

Nullable<T>[Int32]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:5
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-ManagedDiskId

Hiermee geeft u de id van een beheerde schijf.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

VmManagedDiskParameterSetName
Position:8
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Name

Hiermee geeft u de naam van de gegevensschijf die moet worden toegevoegd.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:1
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-SourceImageUri

Hiermee geeft u de bron-URI van de schijf die met deze cmdlet wordt gekoppeld.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:SourceImage

Parametersets

VmNormalDiskParameterSetName
Position:7
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-SourceResourceId

ARM-id van momentopname of herstelpunt van schijf waaruit een schijf moet worden gemaakt.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-StorageAccountType

Hiermee geeft u het type opslagaccount van de beheerde schijf.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

VmManagedDiskParameterSetName
Position:9
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-VhdUri

Hiermee geeft u de URI (Uniform Resource Identifier) op voor het VHD-bestand (virtuele harde schijf) dat moet worden gemaakt wanneer een platforminstallatiekopieën of gebruikersinstallatiekopieën worden gebruikt. Met deze cmdlet wordt het binaire binaire grote object (blob) naar deze locatie gekopieerd. Dit is de locatie van waaruit de virtuele machine moet worden gestart.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

VmNormalDiskParameterSetName
Position:2
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-VM

Hiermee geeft u het lokale virtuele-machineobject waaraan een gegevensschijf moet worden toegevoegd. U kunt de Get-AzVM-cmdlet gebruiken om een virtuele-machineobject op te halen. U kunt de cmdlet New-AzVMConfig gebruiken om een virtuele-machineobject te maken.

Parametereigenschappen

Type:PSVirtualMachine
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:VMProfile

Parametersets

(All)
Position:0
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-WriteAccelerator

Hiermee geeft u op of WriteAccelerator moet worden ingeschakeld of uitgeschakeld op een beheerde gegevensschijf.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

VmManagedDiskParameterSetName
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

PSVirtualMachine

String

CachingTypes

Nullable<T>

Uitvoerwaarden

PSVirtualMachine

PSVirtualMachineScaleSetVM