Set-AzVMDataDisk
Modifica as propriedades de um disco de dados de máquina virtual.
Sintaxe
ChangeWithName
Set-AzVMDataDisk
[-VM] <PSVirtualMachine>
[-Name] <String>
[[-Caching] <CachingTypes>]
[[-DiskSizeInGB] <Int32>]
[-StorageAccountType <String>]
[-DiskEncryptionSetId <String>]
[-WriteAccelerator]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ChangeWithLun
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 o armazena na variável $VM.
O segundo comando modifica o modo de cache do 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 caixa faz com que a máquina virtual seja reiniciada.
Exemplo 2
Modifica as propriedades de um disco de dados de máquina virtual. (autogenerated)
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.
Propriedades do parâmetro
Tipo: Nullable<T> [ CachingTypes ]
Valor padrão: None Valores aceitos: None, ReadOnly, ReadWrite Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: 2 Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.
Propriedades do parâmetro
Tipo: IAzureContextContainer
Valor padrão: None Dá suporte a curingas: False DontShow: False Aliases: AzContext, AzureRmContext, AzureCredential
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: 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.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-DiskSizeInGB
Especifica o tamanho, em gigabytes, para o disco de dados.
Propriedades do parâmetro
Tipo: Nullable<T> [ Int32 ]
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: 3 Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
-Lun
Especifica o LUN (número de unidade lógica) do disco de dados que esse cmdlet modifica.
Propriedades do parâmetro
Tipo: Nullable<T> [ Int32 ]
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
ChangeWithLun
Cargo: 1 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
-Name
Especifica o nome do disco de dados que este cmdlet modifica.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
ChangeWithName
Cargo: 1 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
-StorageAccountType
O tipo de conta do disco gerenciado da máquina virtual.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: 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.
Propriedades do parâmetro
Tipo: PSVirtualMachine
Valor padrão: None Dá suporte a curingas: False DontShow: False Aliases: VMProfile
Conjuntos de parâmetros
(All)
Cargo: 0 Obrigatório: True Valor do pipeline: True Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
-WriteAccelerator
Especifica se WriteAccelerator deve ser habilitado ou desabilitado no disco de dados.
Propriedades do parâmetro
Tipo: SwitchParameter
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters .
Saídas