Set-AzureOSDisk

Syntax

Set-AzureOSDisk
   [-HostCaching] <String>
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [-Profile <AzureSMProfile>]
   -VM <IPersistentVM>
   [<CommonParameters>]

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

Description

The Set-AzureOSDisk cmdlet modifies the host cache mode of the operating system disk of an Azure virtual machine. The supported host cache modes are ReadOnly and ReadWrite. If you run this cmdlet on a virtual machine that is running, that virtual machine restarts.

Examples

Example 1: Set the host cache mode to ReadOnly by using the pipeline

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

This command gets the virtual machine named VirtualMachine02 in the service named ContosoService by using the Get-AzureVM cmdlet. The command passes the virtual machine to the current cmdlet by using the pipeline operator. The current cmdlet sets the host cache mode of the operating system disk of that virtual machine to be ReadOnly.

Example 2: Set the host cache mode to ReadWrite

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

The first command gets the virtual machine named VirtualMachine02 in the service named ContosoService, and then stores it in the variable.

The second command sets the host cache mode of the operating system disk of that virtual machine to be ReadWrite.

Required Parameters

Optional Parameters

Related Links

• Add-AzureVMImage
• Get-AzureOSDisk
• Get-AzureVM
• Get-AzureVMImage
• Set-AzureDataDisk
• Update-AzureVM