Compartilhar via


New-AzDiskUpdateConfig

Cria um objeto de atualização de disco configurável.

Sintaxe

New-AzDiskUpdateConfig
   [[-SkuName] <String>]
   [-Tier <String>]
   [-DiskIOPSReadOnly <Int64>]
   [-DiskMBpsReadOnly <Int64>]
   [-MaxSharesCount <Int32>]
   [-NetworkAccessPolicy <String>]
   [-DiskAccessId <String>]
   [[-OsType] <OperatingSystemTypes>]
   [[-DiskSizeGB] <Int32>]
   [[-Tag] <Hashtable>]
   [-DiskIOPSReadWrite <Int32>]
   [-DiskMBpsReadWrite <Int32>]
   [-PurchasePlan <PSPurchasePlan>]
   [-SupportsHibernation <Boolean>]
   [-EncryptionSettingsEnabled <Boolean>]
   [-DiskEncryptionKey <KeyVaultAndSecretReference>]
   [-KeyEncryptionKey <KeyVaultAndKeyReference>]
   [-DiskEncryptionSetId <String>]
   [-EncryptionType <String>]
   [-BurstingEnabled <Boolean>]
   [-PublicNetworkAccess <String>]
   [-AcceleratedNetwork <Boolean>]
   [-DataAccessAuthMode <String>]
   [-Architecture <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet New-AzDiskUpdateConfig cria um objeto de atualização de disco configurável.

Exemplos

Exemplo 1

$diskupdateconfig = New-AzDiskUpdateConfig -DiskSizeGB 10 -SkuName Premium_LRS -OsType Windows -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';
$diskupdateconfig = Set-AzDiskUpdateDiskEncryptionKey -DiskUpdate $diskupdateconfig -SecretUrl $secretUrl -SourceVaultId $secretId;
$diskupdateconfig = Set-AzDiskUpdateKeyEncryptionKey -DiskUpdate $diskupdateconfig -KeyUrl $keyUrl -SourceVaultId $keyId;
Update-AzDisk -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01' -DiskUpdate $diskupdateconfig;

O primeiro comando cria um objeto de atualização de disco vazio local com tamanho de 10 GB em Premium_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 para o objeto de atualização de disco. O último comando usa o objeto de atualização de disco e atualiza um disco existente com o nome 'Disk01' no grupo de recursos 'ResourceGroup01'.

Exemplo 2

New-AzDiskUpdateConfig -DiskSizeGB 10 | Update-AzDisk -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01';

Esse comando atualiza um disco existente com o nome 'Disk01' no grupo de recursos 'ResourceGroup01' para 10 GB de tamanho de disco.

Parâmetros

-AcceleratedNetwork

True se a imagem da qual o disco do sistema operacional é criado dá 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 compatível com 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 do destino de desempenho provisionado do disco. O estouro 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 a 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

-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

ID do ARM do recurso DiskAccess para usar pontos de extremidade privados em discos

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 ReadOnly. Uma operação pode ser transferida entre 4k e 256 mil bytes.

Tipo:Nullable<T>[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; somente configurável para discos UltraSSD. Uma operação pode ser transferida entre 4k e 256 mil bytes.

Tipo:Int32
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 ReadOnly. MBps significa milhões de bytes por segundo – MB aqui usa a notação ISO, de potências de 10.

Tipo:Nullable<T>[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; somente configurável para discos UltraSSD. MBps significa milhões de bytes por segundo – MB aqui usa a notação ISO, de potências de 10.

Tipo:Int32
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

-EncryptionSettingsEnabled

Habilitar configurações de criptografia 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

-EncryptionType

O tipo de chave usado 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

-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

-MaxSharesCount

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

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

-NetworkAccessPolicy

Política para acessar o disco por meio da rede. Os valores disponíveis são: AllowAll, AllowPrivate, DeyAll

Tipo:String
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

-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

Define o plano de compra do disco. Usado para estabelecer o contexto de compra de qualquer artefato de terceiros por meio do Marketplace.

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 SKU da conta de armazenamento. Os valores disponíveis são Standard_LRS, Premium_LRS, StandardSSD_LRS e UltraSSD_LRS. UltraSSD_LRS só pode ser usado com valor vazio 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

-SupportsHibernation

Indica se o sistema operacional no disco dá suporte à hibernação com $true ou $false

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 chave-valor na forma de uma tabela de hash. Por exemplo: @{key0="value0"; key1=$null; key2="value2"}

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

-Tier

Camada 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

-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

Entradas

String

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

Int32

Hashtable

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

KeyVaultAndSecretReference

KeyVaultAndKeyReference

Saídas

PSDiskUpdate