Compartir a través de

Set-AzureDataDisk

  • Referencia
Módulo:
Azure

Modifica el almacenamiento en caché del host de un disco de datos existente en 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-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>]

Description

El cmdlet Set-AzureDataDisk modifica los atributos de caché de un disco de datos existente en una máquina virtual de Azure. Especifique el disco de datos que se va a actualizar por su número de unidad lógica (LUN).

Ejemplos

Ejemplo 1: Modificación del almacenamiento en caché del host para un disco de datos

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

Este comando obtiene las máquinas virtuales que se ejecutan en el servicio denominado ContosoService mediante el cmdlet Get-AzureVM . El comando los pasa al cmdlet actual mediante el operador de canalización. Ese cmdlet establece el disco de datos en LUN 2 de la máquina virtual denominada VirtualMachine07 para usar el almacenamiento en caché del host readOnly. El comando actualiza la máquina virtual para reflejar los cambios mediante el cmdlet Update-AzureVM .

Ejemplo 2: Modificación del almacenamiento en caché del host para todos los discos de datos de una máquina virtual

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

Este comando obtiene un objeto para la máquina virtual denominada VirtualMachine07 en el servicio en la nube ContosoService. El comando lo pasa al cmdlet Get-AzureDataDisk , que obtiene los discos de datos de esa máquina virtual. A continuación, el cmdlet actual establece el modo de almacenamiento en caché del host de cada disco de datos en ReadWrite. El comando actualiza la máquina virtual para reflejar los cambios.

Parámetros

-DiskName

Especifica el nombre de la configuración del disco de datos que modifica este cmdlet.

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

-HostCaching

Advertencia

No se admite el almacenamiento en caché de disco para discos de 4 TiB o más. Si varios discos están conectados a la máquina virtual, cada disco de menos de 4 TiB será compatible con el almacenamiento en caché.

Al cambiar la configuración de caché de un disco de Azure, se desconecta y se vuelve a conectar el disco de destino. Si se trata del disco del sistema operativo, se reinicia la máquina virtual. Detenga todas las aplicaciones y todos los servicios que podrían verse afectados por esta interrupción antes de cambiar la configuración de caché de disco. El incumplimiento de estas recomendaciones podría provocar datos dañados.

Especifica la configuración de almacenamiento en caché de nivel de host del disco. Los valores válidos son:

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

-LUN

Especifica el LUN para la unidad de datos de la máquina virtual. Los valores válidos son: de 0 a 15.

Tipo:Int32
Posición:1
Valor predeterminado:None
Requerido:True
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 el nuevo tamaño, en gigabytes, para el disco de datos. El nuevo tamaño debe ser mayor que el tamaño actual.

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

-VM

Especifica el objeto de máquina virtual que está conectado al disco de datos. 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