Set-AzureRMVMDataDisk
Modifica as propriedades de um disco de dados de máquina virtual.
Aviso
O módulo PowerShell do AzureRM foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo do Az PowerShell para garantir o suporte e as atualizações contínuas.
Embora o módulo AzureRM ainda possa funcionar, ele não tem suporte ou será mantido, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o módulo Az.
Sintaxe
Set-AzureRMVMDataDisk
[-VM] <PSVirtualMachine>
[-Name] <String>
[[-Caching] <CachingTypes>]
[[-DiskSizeInGB] <Int32>]
[-StorageAccountType <String>]
[-WriteAccelerator]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Set-AzureRMVMDataDisk
[-VM] <PSVirtualMachine>
[-Lun] <Int32>
[[-Caching] <CachingTypes>]
[[-DiskSizeInGB] <Int32>]
[-StorageAccountType <String>]
[-WriteAccelerator]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
O cmdlet Set-AzureRmVMDataDisk 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
PS C:\> $VM = Get-AzureRMVM -ResourceGroupName "ResourceGroup11" -VMName "ContosoVM07"
PS C:\> Set-AzureRmVMDataDisk -VM $VM -Name "DataDisk01" -Caching ReadWrite | Update-AzureRmVM
O primeiro comando obtém a máquina virtual chamada ContosoVM07 usando Get-AzureRmVM. 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-AzureRmVM, que implementa suas alterações. Uma alteração no modo de cobrança faz com que a máquina virtual seja reiniciada.
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: | AzureRmContext, AzureCredential |
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-AzureRmVM.
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
Nullable<T>[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]
Nullable<T>[[Microsoft.Azure.Management.Compute.Models.CachingTypes, Microsoft.Azure.Management.Compute, Version=21.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]