Freigeben über

Add-AzureRmVMDataDisk

  • Referenz
Modul:
AzureRM.Compute

Fügt einem virtuellen Computer oder einer vmss-VM einen Datenträger hinzu.

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul weiterhin funktioniert, wird es nicht mehr Standard tained oder unterstützt, wobei eine fortgesetzte Verwendung nach Ermessen und Risiko des Benutzers erfolgt. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

Syntax

Add-AzureRmVMDataDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-VhdUri] <String>]
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-Lun] <Int32>
   [-CreateOption] <String>
   [[-SourceImageUri] <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzureRmVMDataDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-Lun] <Int32>
   [-CreateOption] <String>
   [[-ManagedDiskId] <String>]
   [[-StorageAccountType] <String>]
   [-WriteAccelerator]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzureRmVMDataDisk
   [-VirtualMachineScaleSetVM] <PSVirtualMachineScaleSetVM>
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-Lun] <Int32>
   [-CreateOption] <String>
   [-ManagedDiskId] <String>
   [[-StorageAccountType] <String>]
   [-WriteAccelerator]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Beschreibung

Das Add-AzureRmVMDataDisk-Cmdlet fügt einem virtuellen Computer oder einer VMss-VM 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

PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
PS C:\> $DataDiskVhdUri01 = "https://contoso.blob.core.windows.net/test/data1.vhd"
PS C:\> $DataDiskVhdUri02 = "https://contoso.blob.core.windows.net/test/data2.vhd"
PS C:\> $DataDiskVhdUri03 = "https://contoso.blob.core.windows.net/test/data3.vhd"
PS C:\> $VirtualMachine = Add-AzureRmVMDataDisk -VM $VirtualMachine -Name 'DataDisk1' -Caching 'ReadOnly' -DiskSizeInGB 10 -Lun 0 -VhdUri $DataDiskVhdUri01 -CreateOption Empty
PS C:\> $VirtualMachine = Add-AzureRmVMDataDisk -VM $VirtualMachine -Name 'DataDisk2' -Caching 'ReadOnly' -DiskSizeInGB 11 -Lun 1 -VhdUri $DataDiskVhdUri02 -CreateOption Empty
PS C:\> $VirtualMachine = Add-AzureRmVMDataDisk -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

PS C:\> $VirtualMachine = Get-AzureRmVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07"
PS C:\> Add-AzureRmVMDataDisk -VM $VirtualMachine -Name "disk1" -VhdUri "https://contoso.blob.core.windows.net/vhds/diskstandard03.vhd" -LUN 0 -Caching ReadOnly -DiskSizeinGB 1 -CreateOption Empty
PS C:\> Update-AzureRmVM -ResourceGroupName "ResourceGroup11" -VM $VirtualMachine

Der erste Befehl ruft den virtuellen Computer mit dem Namen VirtualMachine07 mithilfe des Cmdlets "Get-AzureRmVM " 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

PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
PS C:\> $DataImageUri = "https://contoso.blob.core.windows.net/system/Microsoft.Compute/Images/captured/dataimage.vhd"
PS C:\> $DataDiskUri = "https://contoso.blob.core.windows.net/test/datadisk.vhd"
PS C:\> $VirtualMachine = Add-AzureRmVMDataDisk -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

PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
PS C:\> $DataDiskUri = "https://contoso.blob.core.windows.net/test/datadisk.vhd"
PS C:\> $VirtualMachine = Add-AzureRmVMDataDisk -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.

Beispiel 5: Hinzufügen eines verwalteten Datenträgers zu einem vmss-virtuellen Computer.

PS C:\> $disk = Get-AzureRmDisk -ResourceGroupName $rgname -DiskName $diskname0
PS C:\> $VmssVM = Get-AzureRmVmssVM -ResourceGroupName "myrg" -VMScaleSetName "myvmss" -InstanceId 0
PS C:\> $VmssVM = Add-AzureRmVMDataDisk -VirtualMachineScaleSetVM $VmssVM -Lun 0 -DiskSizeInGB 10 -CreateOption Attach -StorageAccountType Standard_LRS -ManagedDiskId $disk.Id
PS C:\> Update-AzureRmVmssVM -VirtualMachineScaleSetVM $VmssVM

Der erste Befehl ruft einen vorhandenen verwalteten Datenträger ab. Der nächste Befehl ruft einen vorhandenen vmss-virtuellen Computer ab, der durch den Ressourcengruppennamen, den Vmss-Namen und die Instanz-ID angegeben wird. Mit dem nächsten Befehl wird der vmss-VM, der lokal in $VmssVM gespeichert ist, der verwaltete Datenträger hinzugefügt. Der letzte Befehl aktualisiert die VM vmss mit hinzugefügter Festplatte.

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:

  • Anfügen. 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.
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:AzureRmContext, AzureCredential
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:True
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

-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

-VirtualMachineScaleSetVM

Gibt das VM-Skalierungssatzobjekt des lokalen virtuellen Computers an, dem ein Datenträger hinzugefügt werden soll. Sie können das Cmdlet "Get-AzureRmVmssVM" verwenden, um ein VM-Objekt mit vm-Skalierungsgruppe abzurufen.

Typ:PSVirtualMachineScaleSetVM
Position:0
Standardwert:None
Erforderlich:True
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-AzureRmVM verwenden , um ein Objekt eines virtuellen Computers abzurufen. Sie können das Cmdlet New-AzureRmVMConfig 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

PSVirtualMachineScaleSetVM

String

CachingTypes

Nullable<T>[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Ausgaben

PSVirtualMachine

PSVirtualMachineScaleSetVM