Set-AzVMDataDisk

  • Referência
Módulo:
Az.Compute

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

Syntax

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 armazena-o 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 levantamento 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 este parâmetro são:

  • ReadOnly
  • 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.
Type:Nullable<T>[CachingTypes]
Accepted values:None, ReadOnly, ReadWrite
Position:2
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DiskSizeInGB

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

Type:Nullable<T>[Int32]
Position:3
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Lun

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

Type:Nullable<T>[Int32]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-StorageAccountType

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:PSVirtualMachine
Aliases:VMProfile
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WriteAccelerator

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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