Enable-VMResourceMetering
Resumo
- O cmdlet Enable-VMResourceMetering começa a coletar dados de utilização de recursos para uma máquina virtual ou pool de recursos..
Parâmetros
Parâmetro | Tipo | Escolhas | Valor Padrão | 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 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. |
-ResourcePoolName | string | | Especifica o nome amigável do pool de recursos para o qual você deseja coletar dados de utilização de recursos. |
-ResourcePoolType | string | Escolhas:
| Especifica o tipo de recurso do pool de recursos para o qual você deseja coletar dados de utilização de recursos. |
-VM | string | | Especifica a VM a ser iniciada |
-VMName | string | | Especifica o nome amigável da máquina virtual para a qual você deseja coletar dados de utilização de recursos. |
Exemplos
#Este exemplo começa a coletar dados de utilização de recursos
#em uma máquina virtual chamada TestVM
tasks:
powershell_command:
server: {{ server }}
username: {{ username }}
password: {{ password }}
command: |
Enable-VMResourceMetering -VMName TestVM
register: result
- debug:
msg: |
{{ result.output }}
{{ result.had_errors }}
{{ result.output_errors }}
{{ result.output_warnings }}
#Este exemplo começa a coletar dados de utilização de recursos
#em um pool de recursos chamado TestResourcePool. (Você pode
#determinar se a medição de recursos está habilitada para um
#pool de recursos consultando sua propriedade ResourceMeteringEnabled.)
tasks:
powershell_command:
server: {{ server }}
username: {{ username }}
password: {{ password }}
command: |
Get-VM TestVM | Enable-VMResourceMetering
Get-VM TestVM | Format-List Name,ResourceMeteringEnabled
register: result
- debug:
msg: |
{{ result.output }}
{{ result.had_errors }}
{{ result.output_errors }}
{{ result.output_warnings }}
#Este exemplo usa dois comandos que mostram a medição de recursos
#sendo habilitada e, em seguida, obtém os dados. O primeiro comando
#começa a coletar dados de utilização de recursos para um pool de
#recursos de memória chamado TestResourcePool. (Você pode determinar
#se a medição de recursos está habilitada para um pool de recursos
#consultando sua propriedade ResourceMeteringEnabled.) O segundo
#comando recupera os dados e os formata como uma lista.
tasks:
powershell_command:
server: {{ server }}
username: {{ username }}
password: {{ password }}
command: |
Enable-VMResourceMetering -ResourcePoolName TestResourcePool -ResourcePoolType Memory
Get-VMResourcePool -Name TestResourcePool -ResourcePoolType Memory | Format-List Name,ResourceMeteringEnabled
register: result
- debug:
msg: |
{{ result.output }}
{{ result.had_errors }}
{{ result.output_errors }}
{{ result.output_warnings }}
#Este exemplo começa a coletar dados de utilização de
#recursos em vários pools de recursos com o nome TestResourcePool.
tasks:
powershell_command:
server: {{ server }}
username: {{ username }}
password: {{ password }}
command: |
Enable-VMResourceMetering -Name TestResourcePool -ResourcePoolType @("Processor","VHD","Ethernet","Memory")
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 |