Optimize-VHD
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:
|
-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. |