Compartir a través de

Add-AzureRmVMDataDisk

  • Referencia
Módulo:
AzureRM.Compute

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

Advertencia

El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.

Aunque el módulo AzureRM puede seguir funcionando, ya no se mantiene ni se admite, colocando cualquier uso continuado a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.

Syntax

Add-AzureRmVMDataDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-VhdUri] <String>]
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-Lun] <Int32>
   [-CreateOption] <String>
   [[-SourceImageUri] <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzureRmVMDataDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-Lun] <Int32>
   [-CreateOption] <String>
   [[-ManagedDiskId] <String>]
   [[-StorageAccountType] <String>]
   [-WriteAccelerator]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzureRmVMDataDisk
   [-VirtualMachineScaleSetVM] <PSVirtualMachineScaleSetVM>
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-Lun] <Int32>
   [-CreateOption] <String>
   [-ManagedDiskId] <String>
   [[-StorageAccountType] <String>]
   [-WriteAccelerator]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

El cmdlet Add-AzureRmVMDataDisk agrega un disco de datos a una máquina virtual o una máquina virtual de Vmss. 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

PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
PS C:\> $DataDiskVhdUri01 = "https://contoso.blob.core.windows.net/test/data1.vhd"
PS C:\> $DataDiskVhdUri02 = "https://contoso.blob.core.windows.net/test/data2.vhd"
PS C:\> $DataDiskVhdUri03 = "https://contoso.blob.core.windows.net/test/data3.vhd"
PS C:\> $VirtualMachine = Add-AzureRmVMDataDisk -VM $VirtualMachine -Name 'DataDisk1' -Caching 'ReadOnly' -DiskSizeInGB 10 -Lun 0 -VhdUri $DataDiskVhdUri01 -CreateOption Empty
PS C:\> $VirtualMachine = Add-AzureRmVMDataDisk -VM $VirtualMachine -Name 'DataDisk2' -Caching 'ReadOnly' -DiskSizeInGB 11 -Lun 1 -VhdUri $DataDiskVhdUri02 -CreateOption Empty
PS C:\> $VirtualMachine = Add-AzureRmVMDataDisk -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

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

El primer comando obtiene la máquina virtual denominada VirtualMachine07 mediante el cmdlet Get-AzureRmVM . 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

PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
PS C:\> $DataImageUri = "https://contoso.blob.core.windows.net/system/Microsoft.Compute/Images/captured/dataimage.vhd"
PS C:\> $DataDiskUri = "https://contoso.blob.core.windows.net/test/datadisk.vhd"
PS C:\> $VirtualMachine = Add-AzureRmVMDataDisk -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

PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
PS C:\> $DataDiskUri = "https://contoso.blob.core.windows.net/test/datadisk.vhd"
PS C:\> $VirtualMachine = Add-AzureRmVMDataDisk -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.

Ejemplo 5: Adición de un disco de datos administrado a una máquina virtual de Vmss.

PS C:\> $disk = Get-AzureRmDisk -ResourceGroupName $rgname -DiskName $diskname0
PS C:\> $VmssVM = Get-AzureRmVmssVM -ResourceGroupName "myrg" -VMScaleSetName "myvmss" -InstanceId 0
PS C:\> $VmssVM = Add-AzureRmVMDataDisk -VirtualMachineScaleSetVM $VmssVM -Lun 0 -DiskSizeInGB 10 -CreateOption Attach -StorageAccountType Standard_LRS -ManagedDiskId $disk.Id
PS C:\> Update-AzureRmVmssVM -VirtualMachineScaleSetVM $VmssVM

El primer comando obtiene un disco administrado existente. El siguiente comando obtiene una máquina virtual de Vmss existente dada por el nombre del grupo de recursos, el nombre de vmss y el identificador de instancia. El siguiente comando agrega el disco administrado a la máquina virtual de Vmss almacenada localmente en $VmssVM. El comando final actualiza la máquina virtual de Vmss con el disco de datos agregado.

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
Position:3
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters: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.
Tipo:String
Position:6
valor predeterminado:None
Requerido:True
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters: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]
Position:4
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-Lun

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

Tipo:Nullable<T>[Int32]
Position:5
valor predeterminado:None
Requerido:True
Accept pipeline input:True
Accept wildcard characters:False

-ManagedDiskId

Especifica el identificador de un disco administrado.

Tipo:String
Position:8
valor predeterminado:None
Requerido:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Tipo:String
Position:1
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-SourceImageUri

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

Tipo:String
Aliases:SourceImage
Position:7
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-StorageAccountType

Especifica el tipo de cuenta de almacenamiento del disco administrado.

Tipo:String
Position:9
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters: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
Position:2
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-VirtualMachineScaleSetVM

Especifica el objeto de máquina virtual del conjunto de escalado de máquinas virtuales local al que se va a agregar un disco de datos. Puede usar el cmdlet Get-AzureRmVmssVM para obtener un objeto de máquina virtual del conjunto de escalado de máquinas virtuales.

Tipo:PSVirtualMachineScaleSetVM
Position:0
valor predeterminado:None
Requerido:True
Accept pipeline input:True
Accept wildcard characters: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-AzureRmVM para obtener un objeto de máquina virtual. Puede usar el cmdlet New-AzureRmVMConfig para crear un objeto de máquina virtual.

Tipo:PSVirtualMachine
Aliases:VMProfile
Position:0
valor predeterminado:None
Requerido:True
Accept pipeline input:True
Accept wildcard characters:False

-WriteAccelerator

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

Tipo:SwitchParameter
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

PSVirtualMachine

PSVirtualMachineScaleSetVM

String

CachingTypes

Nullable<T>[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Salidas

PSVirtualMachine

PSVirtualMachineScaleSetVM