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.

Observação

Os cmdlets mostrados nesta documentação são usados para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Confira o módulo Az PowerShell para usar cmdlets a fim de 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 atualizar 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

Esse 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

Esse 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 dessa máquina virtual. 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 esse cmdlet modifica.

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

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ções.

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

Continuar
Ignorar
Perguntar
SilentlyContinue
Stop
Suspend

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 da 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 lê. 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 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