Compartir a través de

Add-AzVMDataDisk

  • Referencia
Módulo:
Az.Compute

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

Sintaxis

Add-AzVMDataDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-VhdUri] <String>]
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-Lun] <Int32>
   [-CreateOption] <String>
   [[-SourceImageUri] <String>]
   [-DiskEncryptionSetId <String>]
   [-DeleteOption <String>]
   [-SourceResourceId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzVMDataDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-Lun] <Int32>
   [-CreateOption] <String>
   [[-ManagedDiskId] <String>]
   [[-StorageAccountType] <String>]
   [-DiskEncryptionSetId <String>]
   [-WriteAccelerator]
   [-DeleteOption <String>]
   [-SourceResourceId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

El cmdlet Add-AzVMDataDisk agrega un disco de datos a una máquina virtual. Puede agregar un disco de datos al crear una máquina virtual o lo puede agregar a una máquina virtual existente.

Ejemplos

Ejemplo 1: Adición de discos de datos a una nueva máquina virtual

$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
$DataDiskVhdUri01 = "https://contoso.blob.core.windows.net/test/data1.vhd"
$DataDiskVhdUri02 = "https://contoso.blob.core.windows.net/test/data2.vhd"
$DataDiskVhdUri03 = "https://contoso.blob.core.windows.net/test/data3.vhd"
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name 'DataDisk1' -Caching 'ReadOnly' -DiskSizeInGB 10 -Lun 0 -VhdUri $DataDiskVhdUri01 -CreateOption Empty
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name 'DataDisk2' -Caching 'ReadOnly' -DiskSizeInGB 11 -Lun 1 -VhdUri $DataDiskVhdUri02 -CreateOption Empty
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name 'DataDisk3' -Caching 'ReadOnly' -DiskSizeInGB 12 -Lun 2 -VhdUri $DataDiskVhdUri03 -CreateOption Empty

El primer comando crea un objeto de máquina virtual y, a continuación, lo almacena en la variable $VirtualMachine. El comando asigna un nombre y un tamaño a la máquina virtual. Los tres siguientes comandos asignan rutas de acceso de tres discos de datos a las variables $DataDiskVhdUri01, $DataDiskVhdUri02 y $DataDiskVhdUri03. Este enfoque solo es para la legibilidad de los siguientes comandos. Los tres comandos finales agregan un disco de datos a la máquina virtual almacenada en $VirtualMachine. El comando especifica el nombre y la ubicación del disco y otras propiedades del disco. El identificador URI de cada disco se almacena en $DataDiskVhdUri01, $DataDiskVhdUri02 y DataDiskVhdUri03 $.

Ejemplo 2: Adición de un disco de datos a una máquina virtual existente

$VirtualMachine = Get-AzVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07"
Add-AzVMDataDisk -VM $VirtualMachine -Name "disk1" -VhdUri "https://contoso.blob.core.windows.net/vhds/diskstandard03.vhd" -LUN 0 -Caching ReadOnly -DiskSizeinGB 1 -CreateOption Empty
Update-AzVM -ResourceGroupName "ResourceGroup11" -VM $VirtualMachine

El primer comando obtiene la máquina virtual denominada VirtualMachine07 mediante el cmdlet Get-AzVM . El comando almacena la máquina virtual en la variable $VirtualMachine . El segundo comando agrega un disco de datos a la máquina virtual almacenada en $VirtualMachine. El comando final actualiza el estado de la máquina virtual almacenada en $VirtualMachine en ResourceGroup11.

Ejemplo 3: Adición de un disco de datos a una nueva máquina virtual desde una imagen de usuario generalizada

$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
$DataImageUri = "https://contoso.blob.core.windows.net/system/Microsoft.Compute/Images/captured/dataimage.vhd"
$DataDiskUri = "https://contoso.blob.core.windows.net/test/datadisk.vhd"
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name "disk1" -SourceImageUri $DataImageUri -VhdUri $DataDiskUri -Lun 0 -DiskSizeinGB 10 -CreateOption FromImage

El primer comando crea un objeto de máquina virtual y lo almacena en la variable $VirtualMachine. El comando asigna un nombre y un tamaño a la máquina virtual. Los dos comandos siguientes asignan rutas de acceso para la imagen de datos y los discos de datos a la $DataImageUri y $DataDiskUri variables respectivamente. Este enfoque se usa para mejorar la legibilidad de los siguientes comandos. Los comandos finales agregan un disco de datos a la máquina virtual almacenada en $VirtualMachine. El comando especifica el nombre y la ubicación del disco y otras propiedades del disco.

Ejemplo 4: Agregar discos de datos a una nueva máquina virtual desde una imagen de usuario especializada

$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
$DataDiskUri = "https://contoso.blob.core.windows.net/test/datadisk.vhd"
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name "dd1" -VhdUri $DataDiskUri -Lun 0 -DiskSizeinGB 10 -CreateOption Attach

El primer comando crea un objeto de máquina virtual y lo almacena en la variable $VirtualMachine. El comando asigna un nombre y un tamaño a la máquina virtual. Los comandos siguientes asignan rutas de acceso del disco de datos a la variable $DataDiskUri. Este enfoque se usa para mejorar la legibilidad de los siguientes comandos. El comando final agrega un disco de datos a la máquina virtual almacenada en $VirtualMachine. El comando especifica el nombre y la ubicación del disco y otras propiedades del disco.

Parámetros

-Caching

Especifica el modo de almacenamiento en caché del disco. Los valores permitidos para este parámetro son los siguientes:

  • ReadOnly
  • ReadWrite
  • Ninguno El valor predeterminado es ReadWrite. Al cambiar este valor, la máquina virtual se reiniciará. Esta configuración afecta a la coherencia y el rendimiento del disco.
Tipo:CachingTypes
Valores aceptados:None, ReadOnly, ReadWrite
Posición:3
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-CreateOption

Especifica si este cmdlet crea un disco en la máquina virtual a partir de una plataforma o una imagen de usuario, crea un disco vacío o conecta un disco existente. Los valores permitidos para este parámetro son los siguientes:

  • Adjuntar. Especifique esta opción para crear una máquina virtual a partir de un disco especializado. Al especificar esta opción, no especifique el parámetro SourceImageUri . El VhdUri es todo lo necesario para indicar a la plataforma Azure la ubicación del disco duro virtual (VHD) que se va a conectar como un disco de datos a la máquina virtual.
  • Vacía. Especifique esto para crear un disco de datos vacío.
  • FromImage. Especifique esta opción para crear una máquina virtual a partir de una imagen o disco generalizados. Al especificar esta opción, debe especificar el parámetro SourceImageUri también para indicar a la plataforma Azure la ubicación del disco duro virtual que se va a conectar como un disco de datos. El parámetro VhdUri se usa como ubicación que identifica dónde se almacenará el disco de datos VHD cuando la máquina virtual la use.
  • Vacía. Este valor se usa al crear un disco de datos vacío.
  • Copiar. Este valor se usa para crear un disco de datos a partir de una instantánea u otro disco. Restaurar: este valor se usa para crear un disco de datos a partir de un punto de restauración de disco.
Tipo:String
Posición:6
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DeleteOption

Opción De eliminación de disco de datos. Especifica qué acción realizar en el disco después de la eliminación de la máquina virtual. Las opciones son: Desasociar, Eliminar.

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

-DiskEncryptionSetId

Especifica el identificador de recurso del conjunto de cifrado de disco administrado por el cliente. Esto solo se puede especificar para el disco administrado.

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

-DiskSizeInGB

Especifica el tamaño, en gigabytes, de un disco vacío que se va a conectar a una máquina virtual.

Tipo:Nullable<T>[Int32]
Posición:4
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Lun

Especifica el número de unidad lógica (LUN) de un disco de datos.

Tipo:Nullable<T>[Int32]
Posición:5
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ManagedDiskId

Especifica el identificador de un disco administrado.

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

-Name

Especifica el nombre del disco de datos que se va a agregar.

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

-SourceImageUri

Especifica el URI de origen del disco que este cmdlet asocia.

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

-SourceResourceId

Id. de ARM del punto de restauración de instantáneas o de disco desde el que se va a crear un disco.

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

-StorageAccountType

Especifica el tipo de cuenta de almacenamiento del disco administrado.

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

-VhdUri

Especifica el identificador uniforme de recursos (URI) para el archivo de disco duro virtual (VHD) que se va a crear cuando se usa una imagen de plataforma o una imagen de usuario. Este cmdlet copia el objeto binario binario de imagen (blob) en esta ubicación. Esta es la ubicación desde la que se va a iniciar la máquina virtual.

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

-VM

Especifica el objeto de máquina virtual local al que se va a agregar un disco de datos. Puede usar el cmdlet Get-AzVM para obtener un objeto de máquina virtual. Puede usar el cmdlet New-AzVMConfig para crear un objeto de máquina virtual.

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

-WriteAccelerator

Especifica si WriteAccelerator debe estar habilitado o deshabilitado en un disco de datos administrado.

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

Entradas

PSVirtualMachine

String

CachingTypes

Nullable<T>[[System.Int32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Salidas

PSVirtualMachine

PSVirtualMachineScaleSetVM