Add-AzVMDataDisk

Módulo:
Az.Compute Module

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

Sintaxis

VmNormalDiskParameterSetName (valor predeterminado) 

Add-AzVMDataDisk
    [-VM] <PSVirtualMachine>
    [[-Name] <String>]
    [[-VhdUri] <String>]
    [[-Caching] <CachingTypes>]
    [[-DiskSizeInGB] <Int32>]
    [-Lun] <Int32>
    [-CreateOption] <String>
    [[-SourceImageUri] <String>]
    [-DiskEncryptionSetId <String>]
    [-DeleteOption <String>]
    [-SourceResourceId <String>]
    [-DiskIOPSReadWrite <Int64>]
    [-DiskMBpsReadWrite <Int64>]
    [-StorageFaultDomainAlignment <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

VmManagedDiskParameterSetName 

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>]
    [-DiskIOPSReadWrite <Int64>]
    [-DiskMBpsReadWrite <Int64>]
    [-StorageFaultDomainAlignment <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 puede agregar un disco de datos 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 comandos siguientes asignan rutas de acceso de tres discos de datos a las variables $DataDiskVhdUri 01, $DataDiskVhdUri 02 y $DataDiskVhdUri 03. 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 URI de cada disco se almacena en $DataDiskVhdUri 01, $DataDiskVhdUri 02 y $DataDiskVhdUri 03.

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.

Ejemplo 5: Adición de un disco de datos UltraSSD con IOPS y rendimiento personalizados

$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_D2s_v3"
$VirtualMachine = Add-AzVMDataDisk -VM $VirtualMachine -Name "UltraData1" -Lun 0 -CreateOption 'Empty' -DiskSizeInGB 10 -Caching 'None' -StorageAccountType 'UltraSSD_LRS' -DiskIOPSReadWrite 5000 -DiskMBpsReadWrite 200

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. El segundo comando agrega un disco de datos UltraSSD con IOPS personalizados (operaciones de entrada y salida por segundo) establecidos en 5000 y el rendimiento establecido en 200 MB por segundo. Estos parámetros permiten ajustar el rendimiento del disco para UltraSSD_LRS y PremiumV2_LRS tipos de cuenta de almacenamiento durante la creación implícita de discos.

Parámetros

-Caching

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

  • ReadOnly
  • Lectura y escritura.
  • 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.

Propiedades de parámetro

Tipo:CachingTypes
Valor predeterminado:None
Valores aceptados:None, ReadOnly, ReadWrite
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:3
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes: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 aceptables para este parámetro son:

  • 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 que se necesita 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ío. Especifique esto para crear un disco de datos vacío.
  • DesdeImagen. 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 al Azure plataforma la ubicación del disco duro virtual que se va a asociar 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ío. 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.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:6
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-DefaultProfile

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

Propiedades de parámetro

Tipo:IAzureContextContainer
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DiskIOPSReadWrite

Especifica el Read-Write IOPS (Operaciones de entrada y salida por segundo) para el disco cuando StorageAccountType está UltraSSD_LRS o PremiumV2_LRS.

Propiedades de parámetro

Tipo:

Nullable<T>[Int64]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-DiskMBpsReadWrite

Especifica el ancho de banda en MB por segundo para el disco cuando StorageAccountType se UltraSSD_LRS o PremiumV2_LRS.

Propiedades de parámetro

Tipo:

Nullable<T>[Int64]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-DiskSizeInGB

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

Propiedades de parámetro

Tipo:

Nullable<T>[Int32]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:4
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Lun

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

Propiedades de parámetro

Tipo:

Nullable<T>[Int32]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:5
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ManagedDiskId

Especifica el identificador de un disco administrado.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

VmManagedDiskParameterSetName
Posición:8
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Name

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:1
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-SourceImageUri

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:SourceImage

Conjuntos de parámetros

VmNormalDiskParameterSetName
Posición:7
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-StorageAccountType

Especifica el tipo de cuenta de almacenamiento del disco administrado.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

VmManagedDiskParameterSetName
Posición:9
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-StorageFaultDomainAlignment

Especifica el tipo de alineación del dominio de error de almacenamiento para el disco de datos. Los valores válidos son "Aligned" y "BestEffortAligned". "Alineado" asigna dominios de error de almacenamiento en disco a dominios de error de proceso; Se produce un error en la implementación si el disco no admite suficientes FD. "BestEffortAligned" intenta la asignación, pero deja el disco no asignado si no admite suficientes FD. Solo es válido para las máquinas virtuales dentro de vmSS Flex; CRP devuelve BadRequest para máquinas virtuales independientes.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Valores aceptados:Aligned, BestEffortAligned
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

VmNormalDiskParameterSetName
Posición:2
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:PSVirtualMachine
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:VMProfile

Conjuntos de parámetros

(All)
Posición:0
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-WriteAccelerator

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

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

VmManagedDiskParameterSetName
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

PSVirtualMachine

String

CachingTypes

Nullable<T>

Salidas

PSVirtualMachine

PSVirtualMachineScaleSetVM