Freigeben über

Set-AzureRMVMDataDisk

  • Referenz
Modul:
AzureRM.Compute

Ändert die Eigenschaften eines Datenträgers eines virtuellen Computers.

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 möglicherweise weiterhin funktioniert, wird es nicht mehr gewartet, und es wird kein Support mehr angeboten. Die weitere Nutzung erfolgt daher nach Ermessen und Risiko des Benutzers. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

Syntax

Set-AzureRMVMDataDisk
   [-VM] <PSVirtualMachine>
   [-Name] <String>
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-StorageAccountType <String>]
   [-WriteAccelerator]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzureRMVMDataDisk
   [-VM] <PSVirtualMachine>
   [-Lun] <Int32>
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-StorageAccountType <String>]
   [-WriteAccelerator]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-AzureRmVMDataDisk ändert die Eigenschaften eines Datenträgers eines virtuellen Computers.

Beispiele

Beispiel 1: Ändern des Cachemodus eines Datenträgers

PS C:\> $VM = Get-AzureRMVM -ResourceGroupName "ResourceGroup11" -VMName "ContosoVM07"
PS C:\> Set-AzureRmVMDataDisk -VM $VM -Name "DataDisk01" -Caching ReadWrite | Update-AzureRmVM

Der erste Befehl ruft den virtuellen Computer ContosoVM07 mithilfe von Get-AzureRmVM ab. Der Befehl speichert sie in der variablen $VM. Mit dem zweiten Befehl wird der Cachemodus für den Datenträger "DataDisk01" auf dem virtuellen Computer in $VM geändert. Der Befehl übergibt das Ergebnis an das Cmdlet Update-AzureRmVM, das Ihre Änderungen implementiert. Eine Änderung des Bargeldmodus bewirkt, dass der virtuelle Computer neu gestartet wird.

Parameter

-Caching

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

  • ReadOnly
  • ReadWrite Der Standardwert ist 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:Nullable<T>[CachingTypes]
Zulässige Werte:None, ReadOnly, ReadWrite
Position:2
Standardwert:None
Erforderlich:False
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 des Datenträgers in Gigabyte an.

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

-Lun

Gibt die logische Einheitennummer (LUN) des Datenträgers an, den dieses Cmdlet ändert.

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

-Name

Gibt den Namen des Datenträgers an, den dieses Cmdlet ändert.

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

-StorageAccountType

Der Kontotyp des virtuellen Computers, der vom virtuellen Computer verwaltet wird.

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

-VM

Gibt den virtuellen Computer an, für den dieses Cmdlet einen Datenträger ändert. Verwenden Sie das Cmdlet Get-AzureRmVM, um ein Objekt eines virtuellen Computers abzurufen.

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

-WriteAccelerator

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

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

Eingaben

PSVirtualMachine

String

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

Nullable<T>[[Microsoft.Azure.Management.Compute.Models.CachingTypes, Microsoft.Azure.Management.Compute, Version=21.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

Ausgaben

PSVirtualMachine