Compartir a través de

New-AzDiskConfig

  • Referencia
Módulo:
Az.Compute

Crea un objeto de disco configurable.

Sintaxis

New-AzDiskConfig
   [[-SkuName] <String>]
   [-Tier <String>]
   [-LogicalSectorSize <Int32>]
   [[-OsType] <OperatingSystemTypes>]
   [[-DiskSizeGB] <Int32>]
   [[-Location] <String>]
   [-EdgeZone <String>]
   [-PurchasePlan <PSPurchasePlan>]
   [-SupportsHibernation <Boolean>]
   [-Zone <String[]>]
   [-HyperVGeneration <String>]
   [-DiskIOPSReadWrite <Int64>]
   [-DiskMBpsReadWrite <Int64>]
   [-DiskIOPSReadOnly <Int64>]
   [-DiskMBpsReadOnly <Int64>]
   [-MaxSharesCount <Int32>]
   [-Tag <Hashtable>]
   [-CreateOption <String>]
   [-StorageAccountId <String>]
   [-ImageReference <ImageDiskReference>]
   [-GalleryImageReference <ImageDiskReference>]
   [-SourceUri <String>]
   [-SourceResourceId <String>]
   [-UploadSizeInBytes <Int64>]
   [-EncryptionSettingsEnabled <Boolean>]
   [-DiskEncryptionKey <KeyVaultAndSecretReference>]
   [-KeyEncryptionKey <KeyVaultAndKeyReference>]
   [-DiskEncryptionSetId <String>]
   [-EncryptionType <String>]
   [-DiskAccessId <String>]
   [-NetworkAccessPolicy <String>]
   [-BurstingEnabled <Boolean>]
   [-PublicNetworkAccess <String>]
   [-AcceleratedNetwork <Boolean>]
   [-DataAccessAuthMode <String>]
   [-Architecture <String>]
   [-PerformancePlus <Boolean>]
   [-OptimizedForFrequentAttach <Boolean>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet New-AzDiskConfig crea un objeto de disco configurable.

Ejemplos

Ejemplo 1

$diskconfig = New-AzDiskConfig -Location 'Central US' -DiskSizeGB 5 -SkuName Standard_LRS -OsType Windows -CreateOption Empty -EncryptionSettingsEnabled $true;
$secretUrl = 'https://myvault.vault-int.azure-int.net/secrets/123/';
$secretId = '/subscriptions/0000000-0000-0000-0000-000000000000/resourceGroups/ResourceGroup01/providers/Microsoft.KeyVault/vaults/TestVault123';
$keyUrl = 'https://myvault.vault-int.azure-int.net/keys/456';
$keyId = '/subscriptions/0000000-0000-0000-0000-000000000000/resourceGroups/ResourceGroup01/providers/Microsoft.KeyVault/vaults/TestVault456';
$diskconfig = Set-AzDiskDiskEncryptionKey -Disk $diskconfig -SecretUrl $secretUrl -SourceVaultId $secretId;
$diskconfig = Set-AzDiskKeyEncryptionKey -Disk $diskconfig -KeyUrl $keyUrl -SourceVaultId $keyId;
New-AzDisk -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01' -Disk $diskconfig;

El primer comando crea un objeto de disco vacío local con un tamaño de 5 GB en Standard_LRS tipo de cuenta de almacenamiento. También establece el tipo de sistema operativo Windows y habilita la configuración de cifrado. Los comandos segundo y tercero establecen la clave de cifrado de disco y la configuración de la clave de cifrado de claves para el objeto de disco. El último comando toma el objeto disk y crea un disco con el nombre "Disk01" en el grupo de recursos "ResourceGroup01".

Ejemplo 2

$diskconfig = New-AzDiskConfig -Location 'Central US' -DiskSizeGB 1023 -SkuName Standard_LRS -OsType Windows -CreateOption Upload -DiskIOPSReadWrite 500 -DiskMBpsReadWrite 8;
New-AzDisk -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01' -Disk $diskconfig;
$diskSas = Grant-AzDiskAccess -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01' -DurationInSecond 86400 -Access 'Write'
$disk = Get-AzDisk -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01'
# $disk.DiskState == 'ReadyToUpload'
 AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer1 /Dest:$diskSas
$disk = Get-AzDisk -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01'
# $disk.DiskState == 'ActiveUpload'
Revoke-AzDiskAccess -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01'

El primer comando crea un objeto de disco local para Upload. El segundo comando toma el objeto disk y crea un disco con el nombre "Disk01" en el grupo de recursos "ResourceGroup01". El tercer comando obtiene la dirección URL de SAS del disco. El cuarto comando obtiene el estado del disco. Si el estado del disco es "ReadyToUpload", un usuario puede cargar un disco de Blob Storage en la dirección URL de SAS de disco mediante AzCopy. Durante la carga, el estado del disco se cambia a "ActiveUpload". El último comando revoca el acceso al disco para la dirección URL de SAS.

Ejemplo 3

$galleryImageReference = @{Id = '/subscriptions/0296790d-427c-48ca-b204-8b729bbd8670/resourceGroups/swaggertests/providers/Microsoft.Compute/galleries/swaggergallery/images/swaggerimagedef/versions/1.0.0'; Lun=1}
$diskConfig = New-AzDiskConfig -Location 'West US' -CreateOption 'FromImage' -GalleryImageReference $galleryImageReference;
New-AzDisk -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01' -Disk $diskConfig

Cree un disco a partir de una versión de imagen de shared Gallery. Id es el identificador de la versión de la imagen de la galería compartida. Lun solo es necesario si el origen es un disco de datos.

Ejemplo 4

$diskconfig = New-AzDiskConfig -Location 'Central US' -SkuName 'Standard_LRS' -OsType 'Windows' -UploadSizeInBytes 35183298347520 -CreateOption 'Upload' -OptimizedForFrequentAttach $true
New-AzDisk -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01' -Disk $diskConfig

Cree un disco con OptimizedForFrequentAttach como true, para mejorar la confiabilidad y el rendimiento de los discos de datos que se desasociarán (más de 5 veces al día) de una máquina virtual y se conectarán a otra.

Parámetros

-AcceleratedNetwork

True si la imagen desde la que se crea el disco del sistema operativo admite redes aceleradas.

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

-Architecture

Arquitectura de CPU compatible con un disco del sistema operativo. Los valores posibles son "X64" y "Arm64".

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

-BurstingEnabled

Habilita la expansión más allá del destino de rendimiento aprovisionado del disco. La expansión está deshabilitada de manera predeterminada. No se aplica a discos Ultra.

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

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
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.

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

-DataAccessAuthMode

Requisitos de autenticación adicionales al exportar o cargar en un disco o instantánea.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
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

-DiskAccessId

Obtiene o establece el identificador de ARM del recurso DiskAccess en el que se usan puntos de conexión privados.

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

-DiskEncryptionKey

Especifica el objeto de clave de cifrado de disco en un disco.

Tipo:KeyVaultAndSecretReference
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 que se va a usar para habilitar el cifrado en reposo.

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

-DiskIOPSReadOnly

Número total de IOPS que se permitirán en todas las máquinas virtuales que montan el disco compartido como ReadOnly. Una operación puede transferir entre 4 000 y 256 000 bytes.

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

-DiskIOPSReadWrite

Número de IOPS permitidas para este disco; solo se puede establecer para discos UltraSSD. Una operación puede transferir entre 4 000 y 256 000 bytes.

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

-DiskMBpsReadOnly

Rendimiento total (MBps) que se permitirá en todas las máquinas virtuales que montan el disco compartido como ReadOnly. MBps significa millones de bytes por segundo: MB aquí usa la notación ISO, de potencias de 10.

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

-DiskMBpsReadWrite

Ancho de banda permitido para este disco; solo se puede establecer para discos UltraSSD. MBps significa millones de bytes por segundo: MB aquí usa la notación ISO, de potencias de 10.

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

-DiskSizeGB

Especifica el tamaño del disco en GB.

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

-EdgeZone

Establece el nombre de la zona perimetral. Si se establece, la consulta se enrutará a la zona perimetral especificada en lugar de a la región principal.

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

-EncryptionSettingsEnabled

Habilite la configuración de cifrado.

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

-EncryptionType

Tipo de clave que se usa para cifrar los datos del disco. Los valores disponibles son: 'EncryptionAtRestWithPlatformKey', 'EncryptionAtRestWithCustomerKey'

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

-GalleryImageReference

Objeto GalleryImageReference. Obligatorio si se crea desde una imagen de la galería. El identificador será el id. de ARM de la versión de la imagen de galley compartida desde la que se va a crear un disco. Se necesita un lun si el origen de la copia es uno de los discos de datos de la imagen de la galería; si es null, se copiará el disco del sistema operativo de la imagen.

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

-HyperVGeneration

Generación del hipervisor de la máquina virtual. Solo se aplica a los discos del sistema operativo. Los valores permitidos son V1 y V2.

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

-ImageReference

Especifica la referencia de imagen en un disco. El identificador será el id. de ARM de la imagen pir o de usuario desde la que se va a crear un disco. Se necesita un LUN si el origen de la copia es uno de los discos de datos de la imagen de la galería; si es null, se copiará el disco del sistema operativo de la imagen.

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

-KeyEncryptionKey

Especifica la clave de cifrado de claves en un disco.

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

-Location

Especifica una ubicación.

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

-LogicalSectorSize

Tamaño del sector lógico en bytes para discos Ultra.

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

-MaxSharesCount

Número máximo de máquinas virtuales que se pueden conectar al disco al mismo tiempo. El valor mayor que uno indica un disco que se puede montar en varias máquinas virtuales al mismo tiempo.

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

-NetworkAccessPolicy

La directiva de acceso de red define la directiva de acceso a la red. Entre los valores posibles se incluyen: 'AllowAll', 'AllowPrivate', 'DenyAll'

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

-OptimizedForFrequentAttach

Establecer esta propiedad en true mejora la confiabilidad y el rendimiento de los discos de datos que suelen (más de 5 veces al día) desasociados de una máquina virtual y conectadas a otra. Esta propiedad no debe establecerse para los discos que no están desasociados y conectados con frecuencia, ya que hace que los discos no se alineen con el dominio de error de la máquina virtual.

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

-OsType

Especifica el tipo de sistema operativo.

Tipo:Nullable<T>[OperatingSystemTypes]
Valores aceptados:Windows, Linux
Posición:1
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-PerformancePlus

Establezca esta marca en true para obtener un aumento en el destino de rendimiento del disco implementado, consulte aquí en el destino de rendimiento correspondiente. Esta marca solo se puede establecer en el tiempo de creación del disco y no se puede deshabilitar después de habilitarse.

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

-PublicNetworkAccess

Directiva para controlar la exportación en el disco.

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

-PurchasePlan

Especifica el plan de compra del disco.

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

-SkuName

Especifica el nombre de SKU de la cuenta de almacenamiento. Los valores disponibles son Standard_LRS, Premium_LRS, StandardSSD_LRS y UltraSSD_LRS, Premium_ZRS y StandardSSD_ZRS. UltraSSD_LRS solo se puede usar con el valor Empty para el parámetro CreateOption.

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

-SourceResourceId

Especifica el identificador de recurso de origen.

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

-SourceUri

Especifica el URI de origen.

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

-StorageAccountId

Especifica el identificador de la cuenta de almacenamiento.

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

-SupportsHibernation

Los clientes pueden establecer la marca SupportsHibernation en el disco.

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

-Tag

Pares clave-valor en forma de tabla hash. Por ejemplo: @{key0="value0"; key1=$null; key2="value2"}

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

-Tier

Nivel de rendimiento del disco.

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

-UploadSizeInBytes

Especifica el tamaño del contenido de la carga, incluido el pie de página del disco duro virtual cuando CreateOption es Upload. Este valor debe estar entre 20972032 (20 MiB + 512 bytes para el pie de página de VHD) y 35183298347520 bytes (32 TiB + 512 bytes para el pie de página VHD).

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

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

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

-Zone

Especifica la lista de zonas lógicas de Disk.

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

Entradas

String

Nullable<T>[[Microsoft.Azure.Management.Compute.Models.OperatingSystemTypes, Microsoft.Azure.Management.Compute, Version=23.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

Int32

String[]

Hashtable

ImageDiskReference

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

KeyVaultAndSecretReference

KeyVaultAndKeyReference

Salidas

PSDisk