Freigeben über

Set-AzureOSDisk

  • Referenz
Modul:
Azure

Ändert den Hostcachemodus eines virtuellen Azure-Computers.

Hinweis

Die in dieser Dokumentation referenzierten Cmdlets dienen zum Verwalten von älteren Azure-Ressourcen, die Azure Service 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-AzureOSDisk
   [-HostCaching] <String>
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureOSDisk
   [[-HostCaching] <String>]
   [-ResizedSizeInGB] <Int32>
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-AzureOSDisk ändert den Hostcachemodus des Betriebssystemdatenträgers eines virtuellen Azure-Computers. Die unterstützten Hostcachemodi sind ReadOnly und ReadWrite. Wenn Sie dieses Cmdlet auf einem virtuellen Computer ausführen, der ausgeführt wird, wird dieser virtuelle Computer neu gestartet.

Beispiele

Beispiel 1: Festlegen des Hostcachemodus auf ReadOnly mithilfe der Pipeline

PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirtualMachine02" | Set-AzureOSDisk -HostCaching "ReadOnly"

Mit diesem Befehl wird der virtuelle Computer "VirtualMachine02" im Dienst "ContosoService" mithilfe des Cmdlets "Get-AzureVM " abgerufen. Der Befehl übergibt den virtuellen Computer mithilfe des Pipelineoperators an das aktuelle Cmdlet. Das aktuelle Cmdlet legt den Hostcachemodus des Betriebssystemdatenträgers dieses virtuellen Computers auf "ReadOnly" fest.

Beispiel 2: Festlegen des Hostcachemodus auf ReadWrite

PS C:\> $VM = Get-AzureVM -ServiceName "ContosoService" -Name "VirtualMachine02"
PS C:\> Set-AzureOSDisk "ReadWrite" -VM $myVM2

Der erste Befehl ruft den virtuellen Computer "VirtualMachine02" im Dienst "ContosoService" ab und speichert ihn dann in der Variablen.

Der zweite Befehl legt den Hostcachemodus des Betriebssystemdatenträgers dieses virtuellen Computers auf "ReadWrite" fest.

Parameter

-HostCaching

Gibt das Hostcache-Attribut für den Betriebssystemdatenträger an. Gültige Werte sind:

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

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

-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 eine neue Größe (in Gigabyte) für den Betriebssystemdatenträger an. Die Größe muss größer als die aktuelle Größe sein.

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

-VM

Gibt den virtuellen Computer an, für den dieses Cmdlet den Betriebssystemdatenträger ändert. 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