Add-AzureRmVmssVMDataDisk
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.
Typ: | PSVirtualMachineScaleSetVM |
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 |