Set-AzureOSDisk
Modifica o modo de cache de host de uma máquina virtual do Azure.
Nota
Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Consulte o módulo Az PowerShell para cmdlets para 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 de host do disco do sistema operacional de uma máquina virtual do Azure. Os modos de cache de host suportados 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"
Este 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, em seguida, armazena-a 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:
- Só de Leitura
- 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ção.
Os valores aceitáveis para este parâmetro são:
- Continuar
- Ignorar
- Informe-se
- SilenciosamenteContinue
- Parar
- Suspender
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 é lido. 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 do 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 |