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 Dienstverwaltungs-APIs verwenden. Cmdlets zum Verwalten von Azure Ressource Manager-Ressourcen finden Sie im Az PowerShell-Modul.

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.

Type:	String
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-InformationAction

Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.

Zulässige Werte für diesen Parameter:

Fortfahren
Ignorieren
Fragen
SilentlyContinue
Beenden
Angehalten

Type:	ActionPreference
Aliases:	infa
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InformationVariable

Gibt eine Informationsvariable an.

Type:	String
Aliases:	iv
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LUN

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

Type:	Int32
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Profile

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

Type:	AzureSMProfile
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Int32
Position:	4
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	IPersistentVM
Aliases:	InputObject
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False