Get-VHD

4 min

Resumo

Obtém o objeto de disco rígido virtual associado a um disco rígido virtual.

Parâmetros

Parâmetro	Tipo	Comentários
-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 um disco rígido virtual deve ser recuperado. 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.
-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.
-DiskNumber	string	Especifica o número do disco associado ao disco rígido virtual a ser recuperado.
-Path	string	Especifica o caminho para o arquivo de disco rígido virtual do disco rígido virtual a ser recuperado. Se um nome de arquivo ou caminho relativo for especificado, o caminho será calculado em relação ao diretório de trabalho atual.
-VMId	string	Especifica o identificador de máquina virtual da máquina virtual cujos discos rígidos virtuais devem ser recuperados.

Exemplos

# Exemplo: Obtém o disco rígido virtual onde está o caminho para o arquivo do disco rígido virtual C:\test\testvhdx.vhdx.
tasks:
  powershell_command:
    server: {{ server }}
    username: {{ username }}
    password: {{ password }}
    command: |
      Get-VHD -Path C:\test\testvhdx.vhdx
  register: result
- debug:
    msg: |
      {{ result.output }}
      {{ result.had_errors }}
      {{ result.output_errors }}
      {{ result.output_warnings }}

# Exemplo: Obtém o disco rígido virtual conectado ao sistema com o disco número 6.
tasks:
  powershell_command:
    server: {{ server }}
    username: {{ username }}
    password: {{ password }}
    command: |
      Get-VHD -DiskNumber 6
  register: result
- debug:
    msg: |
      {{ result.output }}
      {{ result.had_errors }}
      {{ result.output_errors }}
      {{ result.output_warnings }}

# Exemplo: Obtém os objetos de disco rígido virtual associados à máquina virtual TestVM, 
# usando o recurso de pipeline para o parâmetro VMId.
tasks:
  powershell_command:
    server: {{ server }}
    username: {{ username }}
    password: {{ password }}
    command: |
      Get-VM -VMName TestVM | Select-Object -Property VMId | Get-VHD
  register: result
- debug:
    msg: |
      {{ result.output }}
      {{ result.had_errors }}
      {{ result.output_errors }}
      {{ result.output_warnings }}

# Exemplo: Obtém os objetos de disco rígido virtual associados à máquina virtual TestVM 
# usando o recurso de pipeline para o parâmetro de caminho.
tasks:
  powershell_command:
    server: {{ server }}
    username: {{ username }}
    password: {{ password }}
    command: |
      Get-VM -VMName TestVM | Select-Object -Property VMId | Get-VHD
  register: result
- debug:
    msg: |
      {{ result.output }}
      {{ result.had_errors }}
      {{ result.output_errors }}
      {{ result.output_warnings }}

# Exemplo: Obtém o objeto de disco rígido virtual para todos os arquivos de disco rígido virtual 
# contidos no diretório especificado e seus subdiretórios.
tasks:
  powershell_command:
    server: {{ server }}
    username: {{ username }}
    password: {{ password }}
    command: |
      Get-ChildItem -Path C:\test -Recurse -Include *.vhd, *.vhdx, *.vhds, *.avhd, *.avhdx | Get-VHD
  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