Add-AzVMDataDisk

  • Referenz
Modul:
Az.Compute

Fügt einem virtuellen Computer einen Datenträger hinzu.

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

Beschreibung

Das Add-AzVMDataDisk-Cmdlet fügt einem virtuellen Computer einen Datenträger hinzu. Ein Datenträger kann beim Erstellen eines virtuellen Computers oder einem bereits vorhandenen virtuellen Computer hinzugefügt werden.

Beispiele

Beispiel 1: Hinzufügen von Datenträgern zu einem neuen virtuellen Computer

$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

Der erste Befehl erstellt ein VM-Objekt und speichert es in der Variablen $VirtualMachine. Der Befehl weist dem virtuellen Computer einen Namen und eine Größe zu. Die nächsten drei Befehle weisen den Variablen „$DataDiskVhdUri01“, „$DataDiskVhdUri02“ und „$DataDiskVhdUri03“ Pfade von drei Datenträgern zu. Dieser Ansatz dient nur zur Lesbarkeit der folgenden Befehle. Die letzten drei Befehle fügen dem virtuellen Computer, der in $VirtualMachine gespeichert ist, jeweils einen Datenträger hinzu. Der Befehl gibt den Namen und speicherort für den Datenträger und andere Eigenschaften des Datenträgers an. Der URI des jeweiligen Datenträgers wird in $DataDiskVhdUri01, $DataDiskVhdUri02 bzw. $DataDiskVhdUri03 gespeichert.

Beispiel 2: Hinzufügen eines Datenträgers zu einem vorhandenen virtuellen Computer

$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

Der erste Befehl ruft den virtuellen Computer mit dem Namen VirtualMachine07 mithilfe des Cmdlets "Get-AzVM " ab. Der Befehl speichert den virtuellen Computer in der Variablen $VirtualMachine . Mit dem zweiten Befehl wird dem virtuellen Computer, der in $VirtualMachine gespeichert ist, ein Datenträger hinzugefügt. Der letzte Befehl aktualisiert den Zustand des virtuellen Computers, der in $VirtualMachine in ResourceGroup11 gespeichert ist.

Beispiel 3: Hinzufügen eines Datenträgers zu einem neuen virtuellen Computer aus einem generalisierten Benutzerimage

$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

Der erste Befehl erstellt ein Objekt des virtuellen Computers und speichert es in der variablen $VirtualMachine. Der Befehl weist dem virtuellen Computer einen Namen und eine Größe zu. Die nächsten beiden Befehle weisen den variablen $DataImageUri bzw. $DataDiskUri Pfade für das Datenimage und die Datenträger zu. Dieser Ansatz wird verwendet, um die Lesbarkeit der folgenden Befehle zu verbessern. Mit den letzten Befehlen wird dem virtuellen Computer, der in $VirtualMachine gespeichert ist, ein Datenträger hinzugefügt. Der Befehl gibt den Namen und speicherort für den Datenträger und andere Eigenschaften des Datenträgers an.

Beispiel 4: Hinzufügen von Datenträgern zu einem neuen virtuellen Computer aus einem speziellen Benutzerimage

$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

Der erste Befehl erstellt ein Objekt des virtuellen Computers und speichert es in der variablen $VirtualMachine. Der Befehl weist dem virtuellen Computer einen Namen und eine Größe zu. Mit den nächsten Befehlen werden Pfade des Datenträgers der variablen $DataDiskUri zugewiesen. Dieser Ansatz wird verwendet, um die Lesbarkeit der folgenden Befehle zu verbessern. Der letzte Befehl fügt dem virtuellen Computer, der in $VirtualMachine gespeichert ist, einen Datenträger hinzu. Der Befehl gibt den Namen und speicherort für den Datenträger und andere Eigenschaften des Datenträgers an.

Parameter

-Caching

Gibt den Cachemodus des Datenträgers an. Zulässige Werte für diesen Parameter:

  • ReadOnly
  • ReadWrite
  • None The default value is ReadWrite. Wenn Sie diesen Wert ändern, wird der virtuelle Computer neu gestartet. Diese Einstellung wirkt sich auf die Konsistenz und Leistung des Datenträgers aus.
Typ:CachingTypes
Zulässige Werte:None, ReadOnly, ReadWrite
Position:3
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-CreateOption

Gibt an, ob dieses Cmdlet einen Datenträger auf dem virtuellen Computer aus einer Plattform oder einem Benutzerimage erstellt, einen leeren Datenträger erstellt oder einen vorhandenen Datenträger anfügt. Zulässige Werte für diesen Parameter:

  • Befestigen. Geben Sie diese Option an, um einen virtuellen Computer von einem speziellen Datenträger zu erstellen. Wenn Sie diese Option angeben, geben Sie nicht den SourceImageUri-Parameter an. Der VhdUri ist alles, was erforderlich ist, um der Azure-Plattform den Speicherort der virtuellen Festplatte (VHD) mitzuteilen, die als Datenträger an den virtuellen Computer angefügt werden soll.
  • Leer. Geben Sie dies an, um einen leeren Datenträger zu erstellen.
  • FromImage. Geben Sie diese Option an, um einen virtuellen Computer aus einem generalisierten Image oder Datenträger zu erstellen. Wenn Sie diese Option angeben, müssen Sie auch den Parameter SourceImageUri angeben, um der Azure-Plattform den Speicherort der VHD mitzuteilen, die als Datenträger angefügt werden soll. Der VhdUri-Parameter wird als Speicherort verwendet, der angibt, wo die VHD des Datenträgers gespeichert wird, wenn er vom virtuellen Computer verwendet wird.
  • Leer. Dieser Wert wird beim Erstellen eines leeren Datenträgers verwendet.
  • Kopieren. Dieser Wert wird verwendet, um einen Datenträger aus einer Momentaufnahme oder einem anderen Datenträger zu erstellen. Wiederherstellen: Dieser Wert wird verwendet, um einen Datenträger aus einem Datenträgerwiederherstellungspunkt zu erstellen.
Typ:String
Position:6
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DeleteOption

Option zum Löschen von Datendatenträgern. Gibt an, welche Aktion nach dem Löschen des virtuellen Computers auf dem Datenträger ausgeführt werden soll. Optionen sind: Trennen, Löschen.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DiskEncryptionSetId

Gibt die Ressourcen-ID des vom Kunden verwalteten Datenträgerverschlüsselungssatzes an. Dies kann nur für verwaltete Datenträger angegeben werden.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DiskSizeInGB

Gibt die Größe eines leeren Datenträgers in Gigabyte an, der an einen virtuellen Computer angefügt werden soll.

Typ:Nullable<T>[Int32]
Position:4
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Lun

Gibt die logische Einheitsnummer (LUN) für einen Datenträger an.

Typ:Nullable<T>[Int32]
Position:5
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ManagedDiskId

Gibt die ID eines verwalteten Datenträgers an.

Typ:String
Position:8
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen des hinzuzufügenden Datenträgers an.

Typ:String
Position:1
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-SourceImageUri

Gibt den Quell-URI des Datenträgers an, den dieses Cmdlet anfügt.

Typ:String
Aliase:SourceImage
Position:7
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-SourceResourceId

ARM-ID des Momentaufnahme- oder Datenträgerwiederherstellungspunkts, von dem aus ein Datenträger erstellt werden soll.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-StorageAccountType

Gibt den Speicherkontotyp des verwalteten Datenträgers an.

Typ:String
Position:9
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VhdUri

Gibt den URI (Uniform Resource Identifier) für die virtuelle Festplatte (VHD) an, die erstellt werden soll, wenn ein Plattformimage oder Benutzerimage verwendet wird. Dieses Cmdlet kopiert das Binäre große Objekt (BLOB) des Bilds an diesen Speicherort. Dies ist der Speicherort, von dem aus der virtuelle Computer gestartet werden soll.

Typ:String
Position:2
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VM

Gibt das lokale virtuelle Computerobjekt an, dem ein Datenträger hinzugefügt werden soll. Sie können das Cmdlet Get-AzVM verwenden, um ein Objekt eines virtuellen Computers abzurufen. Sie können das Cmdlet New-AzVMConfig verwenden, um ein Objekt eines virtuellen Computers zu erstellen.

Typ:PSVirtualMachine
Aliase:VMProfile
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WriteAccelerator

Gibt an, ob WriteAccelerator auf einem verwalteten Datenträger aktiviert oder deaktiviert werden soll.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

PSVirtualMachine

String

CachingTypes

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

Ausgaben

PSVirtualMachine

PSVirtualMachineScaleSetVM