Compartir a través de

Add-AzureDataDisk

  • Referencia
Módulo:
Azure

Agrega un disco de datos a una máquina virtual.

Nota:

Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos heredados de Azure que usan las API de Azure Service Manager (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 powerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.

Sintaxis

Add-AzureDataDisk
   [-CreateNew]
   [-DiskSizeInGB] <Int32>
   [-DiskLabel] <String>
   [-LUN] <Int32>
   [-MediaLocation <String>]
   [-HostCaching <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Add-AzureDataDisk
   [-Import]
   [-DiskName] <String>
   [-LUN] <Int32>
   [-HostCaching <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Add-AzureDataDisk
   [-ImportFrom]
   [-DiskLabel] <String>
   [-LUN] <Int32>
   -MediaLocation <String>
   [-HostCaching <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

El cmdlet Add-AzureDataDisk agrega un disco de datos nuevo o existente a un objeto de máquina virtual de Azure. Use el parámetro CreateNew para crear un nuevo disco de datos que tenga un tamaño y una etiqueta especificados. Use el parámetro Import para conectar un disco existente desde el repositorio de imágenes. Use el parámetro ImportFrom para conectar un disco existente desde un blob en una cuenta de almacenamiento. Puede especificar el modo de caché de host del disco de datos conectado.

Ejemplos

Ejemplo 1: Importación de un disco de datos desde el repositorio

PS C:\> Get-AzureVM "ContosoService" -Name "VirtualMachine07" | Add-AzureDataDisk -Import -DiskName "Disk68" -LUN 0 | Update-AzureVM

Este comando obtiene un objeto de máquina virtual para la máquina virtual denominada VirtualMachine07 en el servicio en la nube ContosoService mediante el cmdlet Get-AzureVM . El comando lo pasa al cmdlet actual mediante el operador de canalización. Ese comando asocia un disco de datos existente desde el repositorio a la máquina virtual. El disco de datos tiene un LUN de 0. El comando actualiza la máquina virtual para reflejar los cambios mediante el cmdlet Update-AzureVM .

Ejemplo 2: Agregar un nuevo disco de datos

PS C:\> Get-AzureVM "ContosoService" -Name "VirtualMachine08" | Add-AzureDataDisk -CreateNew -DiskSizeInGB 128 -DiskLabel "main" -LUN 0 | Update-AzureVM

Este comando obtiene un objeto de máquina virtual para la máquina virtual denominada VirtualMachine08. El comando lo pasa al cmdlet actual. Ese comando adjunta un nuevo disco de datos denominado MyNewDisk.vhd. El cmdlet crea el disco en el contenedor vhds en la cuenta de almacenamiento predeterminada de la suscripción actual. El comando actualiza la máquina virtual para reflejar los cambios.

Ejemplo 3: Agregar un disco de datos desde una ubicación especificada

PS C:\> Get-AzureVM "ContosoService" -Name "Database" | Add-AzureDataDisk -ImportFrom -MediaLocation "https://contosostorage.blob.core.windows.net/container07/Disk14.vhd" -DiskLabel "main" -LUN 0 | Update-AzureVM

Este comando obtiene un objeto de máquina virtual para la máquina virtual denominada Database. El comando lo pasa al cmdlet actual. Ese comando asocia un disco de datos existente denominado Disk14.vhd desde la ubicación especificada. El comando actualiza la máquina virtual para reflejar los cambios.

Parámetros

-CreateNew

Indica que este cmdlet crea un disco de datos.

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

-DiskLabel

Especifica la etiqueta de disco para un nuevo disco de datos.

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

-DiskName

Especifica el nombre de un disco de datos en el repositorio de discos.

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

-DiskSizeInGB

Especifica el tamaño del disco lógico, en gigabytes, para un nuevo disco de datos.

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

-HostCaching

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

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

-Import

Indica que este cmdlet importa un disco de datos existente desde el repositorio de imágenes.

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

-ImportFrom

Indica que este cmdlet importa un disco de datos existente de un blob en una cuenta de almacenamiento.

Tipo:SwitchParameter
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
  • Ignorar
  • Inquire
  • SilentlyContinue
  • Stop
  • 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 número de unidad lógica (LUN) de la unidad de datos de la máquina virtual. Los valores válidos son: de 0 a 15. Cada disco de datos debe tener un LUN único.

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

-MediaLocation

Especifica la ubicación del blob en una cuenta de Azure Storage donde este cmdlet almacena el disco de datos. Si no especifica una ubicación, el cmdlet almacena el disco de datos en el contenedor vhds en la cuenta de almacenamiento predeterminada de la suscripción actual. Si no existe un contenedor de vhds, el cmdlet crea un contenedor de vhds.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
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

-VM

Especifica el objeto de máquina virtual al que este cmdlet asocia un 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