Compartilhar via

New-AzDiskConfig

  • Referência
Módulo:
Az.Compute

Cria um objeto de disco configurável.

Sintaxe

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

O cmdlet New-AzDiskConfig cria um objeto de disco configurável.

Exemplos

Exemplo 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;

O primeiro comando cria um objeto de disco vazio local com tamanho de 5 GB em Standard_LRS tipo de conta de armazenamento. Ele também define o tipo de sistema operacional Windows e habilita as configurações de criptografia. O segundo e o terceiro comandos definem as configurações de chave de criptografia de disco e chave de criptografia de chave para o objeto de disco. O último comando usa o objeto de disco e cria um disco com o nome 'Disk01' no grupo de recursos 'ResourceGroup01'.

Exemplo 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'

O primeiro comando cria um objeto de disco local para Upload. O segundo comando usa o objeto de disco e cria um disco com o nome 'Disk01' no grupo de recursos 'ResourceGroup01'. O terceiro comando obtém a URL SAS para o disco. O quarto comando obtém o estado do disco. Se o estado do disco for 'ReadyToUpload', um usuário poderá carregar um disco do armazenamento de blobs para a URL SAS do disco usando o AzCopy. Durante o upload, o estado do disco é alterado para 'ActiveUpload'. O último comando revoga o acesso ao disco para a URL SAS.

Exemplo 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

Crie um disco a partir de uma versão de imagem da galeria compartilhada. Id é o id da versão da imagem da galeria compartilhada. O Lun será necessário somente se a origem for um disco de dados.

Exemplo 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

Crie um disco com OptimizedForFrequentAttach como true, para melhorar a confiabilidade e o desempenho dos discos de dados que serão frequentemente (mais de 5 vezes por dia) desanexados de uma máquina virtual e anexados a outra.

Parâmetros

-AcceleratedNetwork

True se a imagem da qual o disco do sistema operacional é criado der suporte à rede acelerada.

Tipo:Nullable<T>[Boolean]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Architecture

Arquitetura de CPU suportada por um disco do sistema operacional. Os valores possíveis são "X64" e "Arm64".

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-BurstingEnabled

Permite a intermitência além da meta de desempenho provisionada do disco. O bursting está desabilitado por padrão. Não se aplica a discos Ultra.

Tipo:Nullable<T>[Boolean]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CreateOption

Especifica se esse cmdlet cria um disco na máquina virtual a partir de uma plataforma ou imagem de usuário, cria um disco vazio ou anexa um disco existente.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-DataAccessAuthMode

Requisitos de autenticação adicionais ao exportar ou carregar em um disco ou instantâneo.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DiskAccessId

Obtém ou define a ID do ARM do recurso DiskAccess para usar pontos de extremidade privados em.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-DiskEncryptionKey

Especifica o objeto de chave de criptografia de disco em um disco.

Tipo:KeyVaultAndSecretReference
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-DiskEncryptionSetId

Especifica a ID do recurso do conjunto de criptografia de disco a ser usado para habilitar a criptografia em repouso.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-DiskIOPSReadOnly

O número total de IOPS que serão permitidos em todas as VMs que montam o disco compartilhado como Somente leitura. Uma operação pode transferir entre 4k e 256k bytes.

Tipo:Int64
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-DiskIOPSReadWrite

O número de IOPS permitido para este disco; configurável apenas para discos UltraSSD. Uma operação pode transferir entre 4k e 256k bytes.

Tipo:Int64
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-DiskMBpsReadOnly

A taxa de transferência total (MBps) que será permitida em todas as VMs que montam o disco compartilhado como Somente leitura. MBps significa milhões de bytes por segundo - MB aqui usa a notação ISO, de potências de 10.

Tipo:Int64
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-DiskMBpsReadWrite

A largura de banda permitida para este disco; configurável apenas para discos UltraSSD. MBps significa milhões de bytes por segundo - MB aqui usa a notação ISO, de potências de 10.

Tipo:Int64
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-DiskSizeGB

Especifica o tamanho do disco em GB.

Tipo:Int32
Cargo:2
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-EdgeZone

Define o nome da zona de borda. Se definido, a consulta será roteada para a zona de borda especificada em vez da região principal.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-EncryptionSettingsEnabled

Ative as configurações de criptografia.

Tipo:Nullable<T>[Boolean]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-EncryptionType

O tipo de chave usada para criptografar os dados do disco. Os valores disponíveis são: 'EncryptionAtRestWithPlatformKey', 'EncryptionAtRestWithCustomerKey'

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-GalleryImageReference

O objeto GalleryImageReference. Obrigatório se estiver criando a partir de uma imagem da galeria. O id será o ID do ARM da versão da imagem de galera compartilhada a partir da qual criar um disco. Um lun será necessário se a origem da cópia for um dos discos de dados na imagem da galeria; se for nulo, o disco do sistema operacional da imagem será copiado.

Tipo:ImageDiskReference
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-HyperVGeneration

A geração do hipervisor da Máquina Virtual. Aplicável somente a discos do sistema operacional. Os valores permitidos são V1 e V2.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ImageReference

Especifica a referência de imagem em um disco. A ID será a ID do ARM do PIR ou da imagem do usuário a partir da qual criar um disco. Um LUN será necessário se a origem da cópia for um dos discos de dados na imagem da galeria; se for nulo, o disco do sistema operacional da imagem será copiado.

Tipo:ImageDiskReference
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-KeyEncryptionKey

Especifica a chave de criptografia de chave em um disco.

Tipo:KeyVaultAndKeyReference
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Location

Especifica um local.

Tipo:String
Cargo:3
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-LogicalSectorSize

Tamanho do setor lógico em bytes para discos Ultra.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-MaxSharesCount

O número máximo de VMs que podem ser anexadas ao disco ao mesmo tempo. O valor maior que um indica um disco que pode ser montado em várias VMs ao mesmo tempo.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-NetworkAccessPolicy

A política de acesso à rede define a política de acesso à rede. Os valores possíveis incluem: 'AllowAll', 'AllowPrivate', 'DenyAll'

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-OptimizedForFrequentAttach

Definir essa propriedade como true melhora a confiabilidade e o desempenho dos discos de dados que são frequentemente (mais de 5 vezes por dia) desanexados de uma máquina virtual e anexados a outra. Essa propriedade não deve ser definida para discos que não são desanexados e anexados com frequência, pois faz com que os discos não se alinhem com o domínio de falha da máquina virtual.

Tipo:Nullable<T>[Boolean]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-OsType

Especifica o tipo de sistema operacional.

Tipo:Nullable<T>[OperatingSystemTypes]
Valores aceitos:Windows, Linux
Cargo:1
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-PerformancePlus

Defina esse sinalizador como true para obter um aumento na meta de desempenho do disco implantado, consulte aqui na respectiva meta de desempenho. Esse sinalizador só pode ser definido no momento da criação do disco e não pode ser desabilitado depois de habilitado.

Tipo:Nullable<T>[Boolean]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-PublicNetworkAccess

Política para controlar a exportação no disco.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-PurchasePlan

Especifica o plano de compra do disco.

Tipo:PSPurchasePlan
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-SkuName

Especifica o nome do SKU da conta de armazenamento. Os valores disponíveis são Standard_LRS, Premium_LRS, StandardSSD_LRS e UltraSSD_LRS, Premium_ZRS e StandardSSD_ZRS. UltraSSD_LRS só pode ser usado com o valor Empty para o parâmetro CreateOption.

Tipo:String
Aliases:AccountType
Cargo:0
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-SourceResourceId

Especifica a ID do recurso de origem.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-SourceUri

Especifica o URI de origem.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-StorageAccountId

Especifica a ID da conta de armazenamento.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-SupportsHibernation

Os clientes podem definir o sinalizador SupportsHibernation no disco.

Tipo:Nullable<T>[Boolean]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Tag

Pares de chave-valor na forma de uma tabela de hash. Por exemplo: @{key0="value0"; chave1=$null; chave2="valor2"}

Tipo:Hashtable
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Tier

Nível de desempenho do disco.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-UploadSizeInBytes

Especifica o tamanho do conteúdo do carregamento, incluindo o rodapé VHD quando CreateOption é Upload. Esse valor deve estar entre 20972032 (20 MiB + 512 bytes para o rodapé VHD) e 35183298347520 bytes (32 TiB + 512 bytes para o rodapé VHD).

Tipo:Int64
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Zone

Especifica a lista de zonas lógicas para o disco.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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

Saídas

PSDisk