Optimize-VHD

4 min

Resumo

Cria um novo switch virtual em um ou mais hosts de máquinas virtuais.

Parâmetros

Parâmetro	Tipo	Escolhas \| Valor Padrão	Comentários
-AsJob	string		Executa o cmdlet como um trabalho em segundo plano.
-CimSession	string		Executa o cmdlet em uma sessão remota ou em um computador remoto. Insira um nome de computador ou um objeto de sessão, como a saída de um cmdlet New-CimSession ou Get-CimSession . O padrão é a sessão atual no computador local.
-ComputerName	string		Especifica um ou mais hosts Hyper-V nos quais uma máquina virtual deve ser otimizada. Nomes NetBIOS, endereços IP e nomes de domínio totalmente qualificados são permitidos. O padrão é o computador local. Use localhost ou um ponto (.) para especificar o computador local explicitamente.
-Confirm	string		Solicita confirmação antes de executar o cmdlet.
-Credential	string		Especifica uma ou mais contas de usuário que têm permissão para executar esta ação. O padrão é o usuário atual.
-Mode	string	escolhas: - Full - Pretrimmed - Prezeroed - Quick - Retrim	Especifica o modo no qual o disco rígido virtual deve ser otimizado. Para um disco VHD , o modo padrão é Full . Para um disco VHDX , o modo padrão é Quick . Os modos válidos são os seguintes: Full Verificações completas de blocos zero e recupera blocos não utilizados. (Permitido somente se o disco rígido virtual estiver montado somente leitura.) Pretrimmed funciona como modo rápido , mas não requer que o disco rígido virtual seja montado somente leitura. A detecção de espaço não utilizado é menos eficaz do que o modo Rápido (no qual o disco rígido virtual foi montado somente leitura) porque a verificação não pode consultar informações sobre espaço livre no sistema de arquivos NTFS no disco rígido virtual. Útil quando o arquivo no formato VHDX foi usado por instâncias do sistema operacional que são pelo menos Windows 8 ou Windows Server 2012, ou quando esse cmdlet já foi executado em um arquivo .vhdx no modo Retrim . Prezeroed funciona como modo rápido , mas não requer que o disco rígido virtual seja montado como somente leitura. A detecção de espaço não utilizado será menos eficaz do que se o disco rígido virtual tivesse sido montado como somente leitura, pois a verificação não poderá consultar informações sobre o espaço livre no sistema de arquivos NTFS no disco rígido virtual. Útil se uma ferramenta foi executada anteriormente para zerar todo o espaço livre no disco virtual, pois esse modo de compactação pode recuperar esse espaço para alocações de bloco subsequentes. Essa forma de compactação também pode ser útil no manuseio de discos rígidos virtuais contendo sistemas de arquivos diferentes do NTFS. O Quick recupera blocos não utilizados, mas não verifica blocos zero. (Permitido somente se o disco rígido virtual estiver montado somente leitura.) Retrim envia retrims sem varrer blocos zero ou recuperar blocos não utilizados. (Permitido somente se o disco rígido virtual estiver montado somente leitura.)
-Passthru	string		Especifica que um objeto deve ser passado para o pipeline que representa o disco rígido virtual a ser otimizado.
-Path	string		Especifica um ou mais caminhos para os arquivos de disco rígido virtual dinâmico ou diferencial a serem otimizados.
-WhatIf	string		Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Exemplos

# Executa a operação compacta no modo Completo. (Se o arquivo no formato VHDX não for 
# anexado como somente leitura antes da operação, ele será padronizado para o modo Prezeroed.)
tasks:
  powershell_command:
    server: {{ server }}
    username: {{ username }}
    password: {{ password }}
    command: |
      Optimize-VHD -Path c:\test\dynamic.vhdx -Mode Full
  register: result
- debug:
    msg: |
      {{ result.output }}
      {{ result.had_errors }}
      {{ result.output_errors }}
      {{ result.output_warnings }}

# Executa a operação compacta no modo Retrim. (Se o disco no formato VHDX não estiver 
# montado como somente leitura antes da operação, a execução do cmdlet retornará um erro.)
tasks:
  powershell_command:
    server: {{ server }}
    username: {{ username }}
    password: {{ password }}
    command: |
      Optimize-VHD -Path c:\test\dynamic.vhdx -Mode Retrim
  register: result
- debug:
    msg: |
      {{ result.output }}
      {{ result.had_errors }}
      {{ result.output_errors }}
      {{ result.output_warnings }}

# Executa a operação compacta no modo Rápido. (Se o arquivo de formato VHDX não for anexado 
# como somente leitura antes da operação, o padrão será o modo Pretrimmed.)
tasks:
  powershell_command:
    server: {{ server }}
    username: {{ username }}
    password: {{ password }}
    command: |
      Optimize-VHD -Path c:\test\dynamic.vhdx -Mode Quick
  register: result
- debug:
    msg: |
      {{ result.output }}
      {{ result.had_errors }}
      {{ result.output_errors }}
      {{ result.output_warnings }}

Valores retornados

Chave	Tipo	Retornado quando	Descrição
output	string	Sempre	Saída da execução.
had_errors	boolean	Sempre	Se teve erros.
output_errors	string	Sempre	Erros de saída da execução.
output_warnings	string	Sempre	Avisos de saída.