Enable-VMResourceMetering

4 min

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: Ethernet Memory Processor VHD	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