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 Service Management API. Consulte el módulo de Az PowerShell para cmdlets para administrar recursos de Azure Resource Manager.

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

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.

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

  • None
  • ReadOnly
  • ReadWrite
Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
  • Stop
  • Suspender
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Especifica una variable de información.

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

-LUN

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

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

-Profile

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

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

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

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