Compartilhar via


Set-AzVMDataDisk

Modifica as propriedades de um disco de dados de máquina virtual.

Sintaxe

Set-AzVMDataDisk
   [-VM] <PSVirtualMachine>
   [-Name] <String>
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-StorageAccountType <String>]
   [-DiskEncryptionSetId <String>]
   [-WriteAccelerator]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzVMDataDisk
   [-VM] <PSVirtualMachine>
   [-Lun] <Int32>
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-StorageAccountType <String>]
   [-DiskEncryptionSetId <String>]
   [-WriteAccelerator]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

O cmdlet Set-AzVMDataDisk modifica as propriedades de um disco de dados de máquina virtual.

Exemplos

Exemplo 1: Modificar o modo de cache de um disco de dados

$VM = Get-AzVM -ResourceGroupName "ResourceGroup11" -VMName "ContosoVM07"
Set-AzVMDataDisk -VM $VM -Name "DataDisk01" -Caching ReadWrite | Update-AzVM

O primeiro comando obtém a máquina virtual chamada ContosoVM07 usando Get-AzVM. O comando o armazena na variável $VM. O segundo comando modifica o modo de cache para o disco de dados chamado DataDisk01 na máquina virtual em $VM. O comando passa o resultado para o cmdlet Update-AzVM, que implementa suas alterações. Uma alteração no modo de cobrança faz com que a máquina virtual seja reiniciada.

Exemplo 2

Modifica as propriedades de um disco de dados de máquina virtual. (gerado automaticamente)

Set-AzVMDataDisk -Caching None -Lun 1 -VM <PSVirtualMachine>

Parâmetros

-Caching

Especifica o modo de cache do disco. Os valores aceitáveis para esse parâmetro são:

  • ReadOnly (somente-leitura)
  • ReadWrite O valor padrão é ReadWrite. Alterar esse valor faz com que a máquina virtual seja reiniciada. Essa configuração afeta a consistência e o desempenho do disco.
Tipo:Nullable<T>[CachingTypes]
Valores aceitos:None, ReadOnly, ReadWrite
Cargo:2
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

-DiskEncryptionSetId

Especifica a ID do recurso do conjunto de criptografia de disco gerenciado pelo cliente. Isso só pode ser especificado para o disco gerenciado.

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

-DiskSizeInGB

Especifica o tamanho, em gigabytes, do disco de dados.

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

-Lun

Especifica o LUN (número de unidade lógica) do disco de dados que esse cmdlet modifica.

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

-Name

Especifica o nome do disco de dados que esse cmdlet modifica.

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

-StorageAccountType

O tipo de conta do disco gerenciado da máquina virtual.

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

-VM

Especifica a máquina virtual para a qual esse cmdlet modifica um disco de dados. Para obter um objeto de máquina virtual, use o cmdlet Get-AzVM.

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

-WriteAccelerator

Especifica se WriteAccelerator deve ser habilitado ou desabilitado no disco de dados.

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

Entradas

PSVirtualMachine

String

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

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

Saídas

PSVirtualMachine