Add-AzureRmVmssVMDataDisk

Referenz

Modul:: AzureRM.Compute

Fügt einem vmss-virtuellen Computer 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-AzureRmVmssVMDataDisk
   [-VirtualMachineScaleSetVM] <PSVirtualMachineScaleSetVM>
   [-Lun] <Int32>
   [-CreateOption] <String>
   [-ManagedDiskId] <String>
   [-StorageAccountType <String>]
   [-Caching <CachingTypes>]
   [-DiskSizeInGB <Int32>]
   [-WriteAccelerator]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Beschreibung

Das Add-AzureRmVmssVMDataDisk-Cmdlet fügt einem virtuellen Computer einen Datenträger hinzu.

Beispiele

Beispiel 1: Hinzufügen eines verwalteten Datenträgers zu einer vmss-VM.

PS C:\> $disk = Get-AzureRmDisk -ResourceGroupName $rgname -DiskName $diskname0
PS C:\> $VmssVM = Get-AzureRmVmssVM -ResourceGroupName "myrg" -VMScaleSetName "myvmss" -InstanceId 0
PS C:\> $VmssVM = Add-AzureRmVmssVMDataDisk -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:	Named
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:	2
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

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:	Int32
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Lun

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

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

-ManagedDiskId

Gibt die ID eines verwalteten Datenträgers an.

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

-StorageAccountType

Gibt den Speicherkontotyp des verwalteten Datenträgers an.

Typ:	String
Position:	Named
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.