Freigeben über

Set-AzureDataDisk

  • Referenz
Modul:
Azure

Ändert die Hostzwischenspeicherung eines vorhandenen Datenträgers auf einem virtuellen Azure-Computer.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.

Syntax

Set-AzureDataDisk
   [-HostCaching] <String>
   [-LUN] <Int32>
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureDataDisk
   [-DiskName] <String>
   [-ResizedSizeInGB] <Int32>
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-AzureDataDisk ändert die Cacheattribute eines vorhandenen Datenträgers auf einem virtuellen Azure-Computer. Geben Sie an, welcher Datenträger anhand der logischen Einheitennummer (LUN) aktualisiert werden soll.

Beispiele

Beispiel 1: Ändern der Hostzwischenspeicherung für einen Datenträger

PS C:\> Get-AzureVM "ContosoService" | Set-AzureDataDisk -VM "VirtualMachine07" -LUN 2 -HostCaching ReadOnly | Update-AzureVM

Dieser Befehl ruft die virtuellen Computer ab, die mit dem Dienst "ContosoService" mithilfe des Cmdlets "Get-AzureVM " ausgeführt werden. Der Befehl übergibt sie mithilfe des Pipelineoperators an das aktuelle Cmdlet. Mit diesem Cmdlet wird der Datenträger unter LUN 2 des virtuellen Computers mit dem Namen VirtualMachine07 für die Verwendung des ReadOnly-Hostzwischenspeicherns festgelegt. Mit dem Befehl wird der virtuelle Computer aktualisiert, um Ihre Änderungen mithilfe des Cmdlets Update-AzureVM widerzuspiegeln.

Beispiel 2: Ändern der Hostzwischenspeicherung für alle Datenträger auf einem virtuellen Computer

PS C:\> Get-AzureVM "ContosoService" -Name "VirtualMachine07" | Get-AzureDataDisk | Set-AzureDataDisk -HostCaching ReadWrite | Update-AzureVM

Dieser Befehl ruft ein Objekt für den virtuellen Computer mit dem Namen VirtualMachine07 im ContosoService-Clouddienst ab. Der Befehl übergibt ihn an das Cmdlet "Get-AzureDataDisk ", das die Datenträger für diesen virtuellen Computer abruft. Das aktuelle Cmdlet legt dann den Hostzwischenspeicherungsmodus jeder Datenträger auf ReadWrite fest. Der Befehl aktualisiert den virtuellen Computer, um Ihre Änderungen widerzuspiegeln.

Parameter

-DiskName

Gibt den Namen der Datenträgerkonfiguration an, die dieses Cmdlet ändert.

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

-HostCaching

Warnung

Die Zwischenspeicherung von Datenträgern wird nicht für Datenträger mit einer Größe von 4 TiB und höher unterstützt. Wenn mehrere Datenträger an Ihre VM angefügt sind, unterstützt jeder Datenträger mit 4 TiB oder weniger das Zwischenspeichern.

Durch Ändern der Cacheeinstellung eines Azure-Datenträgers wird der Zieldatenträger getrennt und erneut angefügt. Wenn es sich um den Betriebssystemdatenträger handelt, wird der virtuelle Computer neu gestartet. Beenden Sie alle Anwendungen und Dienste, die von dieser Unterbrechung betroffen sein könnten, bevor Sie die Cacheeinstellung des Datenträgers ändern. Wenn diese Empfehlungen nicht befolgt werden, kann dies zu einer Beschädigung der Daten führen.

Gibt die Einstellungen für die Zwischenspeicherung auf Hostebene des Datenträgers an. Gültige Werte sind:

  • Keine
  • ReadOnly
  • ReadWrite
Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InformationAction

Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.

Zulässige Werte für diesen Parameter:

  • Fortsetzen
  • Ignorieren
  • Inquire
  • SilentlyContinue
  • Beenden
  • Angehalten
Typ:ActionPreference
Aliase:infa
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InformationVariable

Gibt eine Informationsvariable an.

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

-LUN

Gibt die LUN für das Datenlaufwerk auf dem virtuellen Computer an. Gültige Werte sind: 0 bis 15.

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

-Profile

Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.

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

-ResizedSizeInGB

Gibt die neue Größe (in Gigabyte) für den Datenträger an. Die neue Größe muss größer als die aktuelle Größe sein.

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

-VM

Gibt das objekt des virtuellen Computers an, das an den Datenträger angefügt ist. Verwenden Sie das Cmdlet "Get-AzureVM ", um ein Objekt eines virtuellen Computers abzurufen.

Typ:IPersistentVM
Aliase:InputObject
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False