Compartilhar via

Set-AzureDataDisk

  • Referência
Módulo:
Azure

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

Observação

Os cmdlets referenciados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo herdado do PowerShell não é recomendado ao criar novos recursos, pois o ASM está agendado para desativação. Para obter mais informações, confira a desativação do Azure Service Manager.

O módulo do Az PowerShell é o módulo recomendado do PowerShell para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.

Sintaxe

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 atualizar por seu LUN (número de unidade lógica).

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

Esse comando obtém as máquinas virtuais 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

Esse comando obtém um objeto para a máquina virtual chamada VirtualMachine07 no serviço de nuvem ContosoService. O comando o passa para o cmdlet Get-AzureDataDisk , que obtém os discos de dados dessa máquina virtual. Em seguida, o cmdlet atual define o modo de cache de 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 esse cmdlet modifica.

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

-HostCaching

Aviso

O cache de disco não tem suporte para discos 4 TiB e maiores. Se vários discos estiverem anexados à sua VM, cada disco com menos de 4 TiB dará suporte ao cache.

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

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

  • Nenhum
  • ReadOnly
  • ReadWrite
Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InformationAction

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

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

  • Continuar
  • Ignorar
  • Perguntar
  • SilentlyContinue
  • Stop
  • Suspend
Tipo:ActionPreference
Aliases:infa
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InformationVariable

Especifica uma variável de informação.

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

-LUN

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

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

-Profile

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

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

-ResizedSizeInGB

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

Tipo:Int32
Cargo:4
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 .

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