Get-VMSnapshot
Resumo
Obtém os pontos de verificação associados a uma máquina virtual ou ponto de verificação.
Parâmetros
Parâmetro | Tipo | Escolhas | Valor Padrão | Comentários |
|---|---|---|---|
-ChildOf | string | | Especifica o ponto de verificação cujos pontos de verificação filho devem ser recuperados. Isso recupera apenas os filhos imediatos. |
-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 dos quais as máquinas virtuais devem ser recuperadas. 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. |
-Id | string | | Especifica o identificador da máquina virtual a ser recuperada. |
-Name | string | | Especifica o nome da máquina virtual a ser recuperada. |
-ParentOf | string | | Especifica o ponto de verificação cujo ponto de verificação pai imediato deve ser recuperado. |
-SnapshotType | string | | Especifica o tipo dos pontos de verificação a serem recuperados. Os valores permitidos são Standard , Recovery, Planned, Missing, Replica, AppConsistentReplica e SyncedReplica . |
-VM | string | | Especifica a máquina virtual cujos pontos de verificação devem ser recuperados. |
-VMName | string | | Especifica o nome da máquina virtual cujos pontos de verificação devem ser recuperados. |
Exemplos
# Exemplo: Obtém todos os pontos de verificação da máquina virtual TestVM.
tasks:
powershell_command:
server: {{ server }}
username: {{ username }}
password: {{ password }}
command: |
Get-VMSnapshot -VMName TestVM
register: result
- debug:
msg: |
{{ result.output }}
{{ result.had_errors }}
{{ result.output_errors }}
{{ result.output_warnings }}
# Exemplo: Obtém todos os pontos de verificação padrão da máquina virtual TestVM.
tasks:
powershell_command:
server: {{ server }}
username: {{ username }}
password: {{ password }}
command: |
Get-VM -Name TestVM | Get-VMSnapshot -SnapshotType Standard
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 |