Set-AzureOSDisk
Modifica o modo de cache do host de 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-AzureOSDisk
[-HostCaching] <String>
-VM <IPersistentVM>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Set-AzureOSDisk
[[-HostCaching] <String>]
[-ResizedSizeInGB] <Int32>
-VM <IPersistentVM>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Description
O cmdlet Set-AzureOSDisk modifica o modo de cache do host do disco do sistema operacional de uma máquina virtual do Azure. Os modos de cache de host com suporte são ReadOnly e ReadWrite. Se você executar esse cmdlet em uma máquina virtual em execução, essa máquina virtual será reiniciada.
Exemplos
Exemplo 1: Definir o modo de cache do host como Somente leitura usando o pipeline
PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirtualMachine02" | Set-AzureOSDisk -HostCaching "ReadOnly"
Esse comando obtém a máquina virtual chamada VirtualMachine02 no serviço chamado ContosoService usando o cmdlet Get-AzureVM . O comando passa a máquina virtual para o cmdlet atual usando o operador de pipeline. O cmdlet atual define o modo de cache do host do disco do sistema operacional dessa máquina virtual como Somente Leitura.
Exemplo 2: Definir o modo de cache do host como ReadWrite
PS C:\> $VM = Get-AzureVM -ServiceName "ContosoService" -Name "VirtualMachine02"
PS C:\> Set-AzureOSDisk "ReadWrite" -VM $myVM2
O primeiro comando obtém a máquina virtual chamada VirtualMachine02 no serviço chamado ContosoService e a armazena na variável.
O segundo comando define o modo de cache do host do disco do sistema operacional dessa máquina virtual como ReadWrite.
Parâmetros
-HostCaching
Especifica o atributo de cache do host para o disco do sistema operacional. Os valores válidos são:
- 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 |
-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 um novo tamanho, em gigabytes, para o disco do sistema operacional. O tamanho deve ser maior que o tamanho atual.
Type: | Int32 |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VM
Especifica a máquina virtual para a qual esse cmdlet modifica o disco do sistema operacional. 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 |