Compartir a través de

Set-AzureOSDisk

  • Referencia
Módulo:
Azure

Modifica el modo de caché de host de una máquina virtual de Azure.

Nota:

Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos de Azure heredados que usan las API de Azure Service Management (ASM). Este módulo heredado de PowerShell no se recomienda al crear nuevos recursos, ya que ASM está programado para la retirada. Para más información, consulte Retirada de Azure Service Manager.

El módulo Az de PowerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.

Sintaxis

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

Description

El cmdlet Set-AzureOSDisk modifica el modo de caché de host del disco del sistema operativo de una máquina virtual de Azure. Los modos de caché de host admitidos son ReadOnly y ReadWrite. Si ejecuta este cmdlet en una máquina virtual que se está ejecutando, esa máquina virtual se reinicia.

Ejemplos

Ejemplo 1: Establecer el modo de caché del host en ReadOnly mediante la canalización

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

Este comando obtiene la máquina virtual denominada VirtualMachine02 en el servicio denominado ContosoService mediante el cmdlet Get-AzureVM . El comando pasa la máquina virtual al cmdlet actual mediante el operador de canalización. El cmdlet actual establece el modo de caché de host del disco del sistema operativo de esa máquina virtual como ReadOnly.

Ejemplo 2: Establecer el modo de caché del host en ReadWrite

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

El primer comando obtiene la máquina virtual denominada VirtualMachine02 en el servicio denominado ContosoService y, a continuación, la almacena en la variable .

El segundo comando establece el modo de caché de host del disco del sistema operativo de esa máquina virtual como ReadWrite.

Parámetros

-HostCaching

Especifica el atributo de caché del host para el disco del sistema operativo. Los valores válidos son:

  • ReadOnly
  • ReadWrite
Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InformationAction

Especifica cómo responde este cmdlet a un evento de información.

Los valores permitidos para este parámetro son los siguientes:

  • Continuar
  • Ignore
  • Inquire
  • SilentlyContinue
  • Detención
  • Suspender
Tipo:ActionPreference
Alias:infa
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InformationVariable

Especifica una variable de información.

Tipo:String
Alias:iv
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Profile

Especifica el perfil de Azure del que lee este cmdlet. Si no especifica un perfil, este cmdlet lee del perfil predeterminado local.

Tipo:AzureSMProfile
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ResizedSizeInGB

Especifica un nuevo tamaño, en gigabytes, para el disco del sistema operativo. El tamaño debe ser mayor que el tamaño actual.

Tipo:Int32
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-VM

Especifica la máquina virtual para la que este cmdlet modifica el disco del sistema operativo. Para obtener un objeto de máquina virtual, use el cmdlet Get-AzureVM .

Tipo:IPersistentVM
Alias:InputObject
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False