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

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