New-AzDiskUpdateConfig
Cria um objeto de atualização de disco configurável.
Sintaxe
Default (Padrão)
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>]
Descrição
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 permite configurações de criptografia.
O segundo e terceiro comandos definem a chave de criptografia de disco e as configurações de chave de criptografia de chave 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';
Este comando atualiza um disco existente com o nome 'Disk01' no grupo de recursos 'ResourceGroup01' para um tamanho de disco de 10 GB.
Parâmetros
-AcceleratedNetwork
True se a imagem a partir da qual o disco do SO é criado suportar redes aceleradas.
Propriedades dos parâmetros
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: True Valor dos argumentos restantes: False
-Architecture
Arquitetura de CPU suportada por um disco do sistema operacional.
Os valores possíveis são "X64" e "Arm64".
Propriedades dos parâmetros
Tipo: String
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: True Valor dos argumentos restantes: False
-BurstingEnabled
Permite intermitência além do destino de desempenho provisionado do disco.
O bursting está desativado por padrão.
Não se aplica a discos Ultra.
Propriedades dos parâmetros
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: True Valor dos argumentos restantes: False
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: False Suporta curingas: False DontShow: False Pseudónimos: Cf.
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-DataAccessAuthMode
Requisitos de autenticação adicionais ao exportar ou carregar para um disco ou instantâneo.
Propriedades dos parâmetros
Tipo: String
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: True Valor dos argumentos restantes: False
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.
Propriedades dos parâmetros
Tipo: IAzureContextContainer
Valor padrão: None Suporta curingas: False DontShow: False Pseudónimos: AzContext, AzureRmContext, AzureCredential
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-DiskAccessId
ID ARM do recurso DiskAccess para usar pontos de extremidade privados em discos
Propriedades dos parâmetros
Tipo: String
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: True Valor dos argumentos restantes: False
-DiskEncryptionKey
Especifica o objeto de chave de criptografia de disco em um disco.
Propriedades dos parâmetros
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: True Valor dos argumentos restantes: False
-DiskEncryptionSetId
Especifica a ID do recurso do conjunto de criptografia de disco a ser usado para habilitar a criptografia em repouso.
Propriedades dos parâmetros
Tipo: String
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: True Valor dos argumentos restantes: False
-DiskIOPSReadOnly
O número total de IOPS que serão permitidas em todas as VMs que montam o disco compartilhado como Somente Leitura.
Uma operação pode transferir entre 4k e 256k bytes.
Propriedades dos parâmetros
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: True Valor dos argumentos restantes: False
-DiskIOPSReadWrite
O número de IOPS permitido para este disco; apenas configurável para discos UltraSSD.
Uma operação pode transferir entre 4k e 256k bytes.
Propriedades dos parâmetros
Tipo: Int32
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: True Valor dos argumentos restantes: 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.
Propriedades dos parâmetros
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: True Valor dos argumentos restantes: False
-DiskMBpsReadWrite
A largura de banda permitida para este disco; apenas 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.
Propriedades dos parâmetros
Tipo: Int32
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: True Valor dos argumentos restantes: False
-DiskSizeGB
Especifica o tamanho do disco em GB.
Propriedades dos parâmetros
Tipo: Int32
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Posição: 2 Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: True Valor dos argumentos restantes: False
-EncryptionSettingsEnabled
Ativar configurações de criptografia no disco
Propriedades dos parâmetros
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: True Valor dos argumentos restantes: False
-EncryptionType
O tipo de chave usada para criptografar os dados do disco.
Os valores disponíveis são: EncryptionAtRestWithPlatformKey, EncryptionAtRestWithCustomerKey
Propriedades dos parâmetros
Tipo: String
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: True Valor dos argumentos restantes: False
-KeyEncryptionKey
Especifica a chave de criptografia de chave em um disco.
Propriedades dos parâmetros
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: True Valor dos argumentos restantes: False
-MaxSharesCount
O número máximo de VMs que podem ser conectadas ao disco ao mesmo tempo.
Valor maior que um indica um disco que pode ser montado em várias VMs ao mesmo tempo.
Propriedades dos parâmetros
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: True Valor dos argumentos restantes: False
-NetworkAccessPolicy
Política para aceder ao disco através da rede. Os valores disponíveis são: AllowAll, AllowPrivate, DenyAll
Propriedades dos parâmetros
Tipo: String
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: True Valor dos argumentos restantes: False
-OsType
Especifica o tipo de sistema operacional.
Propriedades dos parâmetros
Conjuntos de parâmetros
(All)
Posição: 1 Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: True Valor dos argumentos restantes: False
-PublicNetworkAccess
Política para controlar a exportação no disco.
Propriedades dos parâmetros
Tipo: String
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: True Valor dos argumentos restantes: False
-PurchasePlan
Define o plano de compra para o disco.
Usado para estabelecer o contexto de compra de qualquer artefato de 3ª Parte através do Marketplace.
Propriedades dos parâmetros
Tipo: PSPurchasePlan
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: True Valor dos argumentos restantes: False
-SkuName
Especifica o nome da 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 o valor Empty para o parâmetro CreateOption.
Propriedades dos parâmetros
Tipo: String
Valor padrão: None Suporta curingas: False DontShow: False Pseudónimos: Tipo de Conta
Conjuntos de parâmetros
(All)
Posição: 0 Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: True Valor dos argumentos restantes: False
-SupportsHibernation
Indica se o SO no disco suporta hibernação com $true ou $false
Propriedades dos parâmetros
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: True Valor dos argumentos restantes: False
-Tag
Pares chave-valor na forma de uma tabela de hash.
Por exemplo: @{key0="value0"; chave1=$null; key2="valor2"}
Propriedades dos parâmetros
Tipo: Hashtable
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Posição: 3 Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: True Valor dos argumentos restantes: False
-Tier
Camada de desempenho do disco.
Propriedades dos parâmetros
Tipo: String
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: True Valor dos argumentos restantes: False
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado.
O cmdlet não é executado.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: False Suporta curingas: False DontShow: False Pseudónimos: Wi
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters .
Saídas
