Partilhar via

Set-AzureDataDisk

  • Referência
Módulo:
Azure

Modifica o cache de host de um disco de dados existente em uma máquina virtual do Azure.

Nota

Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Consulte o módulo Az PowerShell para cmdlets para gerenciar recursos do Azure Resource Manager.

Syntax

Set-AzureDataDisk
   [-HostCaching] <String>
   [-LUN] <Int32>
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureDataDisk
   [-DiskName] <String>
   [-ResizedSizeInGB] <Int32>
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

O cmdlet Set-AzureDataDisk modifica os atributos de cache de um disco de dados existente em uma máquina virtual do Azure. Especifique qual disco de dados deve ser atualizado por seu número de unidade lógica (LUN).

Exemplos

Exemplo 1: Modificar o cache do host para um disco de dados

PS C:\> Get-AzureVM "ContosoService" | Set-AzureDataDisk -VM "VirtualMachine07" -LUN 2 -HostCaching ReadOnly | Update-AzureVM

Este comando obtém as máquinas virtuais que são executadas no serviço chamado ContosoService usando o cmdlet Get-AzureVM . O comando os passa para o cmdlet atual usando o operador de pipeline. Esse cmdlet define o disco de dados no LUN 2 da máquina virtual chamada VirtualMachine07 para usar o cache de host ReadOnly. O comando atualiza a máquina virtual para refletir suas alterações usando o cmdlet Update-AzureVM .

Exemplo 2: Modificar o cache do host para todos os discos de dados em uma máquina virtual

PS C:\> Get-AzureVM "ContosoService" -Name "VirtualMachine07" | Get-AzureDataDisk | Set-AzureDataDisk -HostCaching ReadWrite | Update-AzureVM

Este comando obtém um objeto para a máquina virtual chamado VirtualMachine07 no serviço de nuvem ContosoService. O comando o passa para o cmdlet Get-AzureDataDisk , que obtém os discos de dados para essa máquina virtual. Em seguida, o cmdlet atual define o modo de cache do host de cada disco de dados como ReadWrite. O comando atualiza a máquina virtual para refletir suas alterações.

Parâmetros

-DiskName

Especifica o nome da configuração do disco de dados que este cmdlet modifica.

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

-HostCaching

Aviso

A Colocação em Cache do Disco não é suportada para discos de 4 TiB e maiores. Se estiverem ligados vários discos à VM, cada disco que seja mais pequeno do que 4 TiB suporta a colocação em cache.

Alterar a configuração de cache de um disco do Azure desanexa e reanexa o disco de destino. Se for o disco do sistema operacional, a VM será reiniciada. Pare todos os aplicativos/serviços que possam ser afetados por essa interrupção antes de alterar a configuração do cache de disco. Não seguir essas recomendações pode levar à corrupção de dados.

Especifica as configurações de cache no nível do host do disco. Os valores válidos são:

  • None
  • Só de Leitura
  • ReadWrite
Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InformationAction

Especifica como esse cmdlet responde a um evento de informação.

Os valores aceitáveis para este parâmetro são:

  • Continuar
  • Ignorar
  • Informe-se
  • SilenciosamenteContinue
  • Parar
  • Suspender
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Especifica uma variável de informação.

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

-LUN

Especifica o LUN para a unidade de dados na máquina virtual. Os valores válidos são: 0 a 15.

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

-Profile

Especifica o perfil do Azure a partir do qual este cmdlet é lido. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.

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

-ResizedSizeInGB

Especifica o novo tamanho, em gigabytes, para o disco de dados. O novo tamanho deve ser maior do que o tamanho atual.

Type:Int32
Position:4
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VM

Especifica o objeto de máquina virtual anexado ao disco de dados. Para obter um objeto de máquina virtual, use o cmdlet Get-AzureVM .

Type:IPersistentVM
Aliases:InputObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False