Compartilhar via

  • Artigo

Get-CsHealthMonitoringConfiguration

 

Tópico modificado em: 2012-03-23

Retorna informações sobre as definições de configuração de monitoramento de integridade em uso na organização. Essas configurações permitem que administradores executem testes de controle de qualidade sem ter de fornecer os nomes de usuários e as senhas das contas de testes relevantes.

Sintaxe

Get-CsHealthMonitoringConfiguration [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]

Get-CsHealthMonitoringConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrição Detalhada

As transações sintéticas são usadas no Microsoft Lync Server 2010 para se certificar de que os usuários sejam capazes de concluir tarefas comuns com sucesso, como fazer logon no sistema, trocar mensagens instantâneas ou realizar chamadas para um telefone localizado na PSTN (rede telefônica pública comutada). Esses testes podem ser conduzidos "manualmente" por um administrador ou executados automaticamente por um aplicativo, como o Microsoft System Center Operations Manager (anteriormente Microsoft Operations Manager).

As transações sintéticas podem ser conduzidas de duas maneiras diferentes. Muitos administradores usarão os cmdlets CsHealthMonitoringConfiguration para definir as contas de teste de cada um de seus pools de registradores e de diretores. Essas contas de teste são um par de contas de usuários que foram configuradas previamente para uso com transações sintéticas. (normalmente, essas são contas de teste e não contas que pertencem a usuários reais). Com contas de teste configuradas para um pool, os administradores podem executar uma transação sintética nesse pool, sem ter de especificar as identidades (nem fornecer credenciais) das contas dos usuários envolvidos no teste. Em vez disso, a transação sintética utilizará automaticamente as contas de teste pré-configuradas ao realizar as suas verificações.

Como alternativa, os administradores podem executar uma transação sintética utilizando contas de usuários reais. Por exemplo, se dois usuários não puderem trocar mensagens instantâneas, um administrador poderia executar uma transação sintética usando as duas contas dos usuários em questão (em vez de um par de contas de teste). Se você decidir conduzir uma transação sintética usando contas de usuários reais, terá de fornecer as credenciais de cada usuário.

O cmdlet Get-CsHealthMonitoringConfiguration permite recuperar informações sobre as definições de configuração do monitoramento de integridade em uso pela sua organização.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Get-CsHealthMonitoringConfiguration localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do controle de acesso baseado em função (RBAC) que receberam a atribuição desse cmdlet (incluindo qualquer função RBAC personalizada criada por você), execute o seguinte comando do prompt Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsHealthMonitoringConfiguration"}

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

Identidade de Xds

Nome de domínio totalmente qualificado (FQDN) do pool no qual tiverem sido atribuídas as definições de configuração de monitoramento de integridade. Por exemplo: -Identity atl-cs-001.litwareinc.com.

Se esse parâmetro não for incluído, Get-CsHealthMonitoringConfiguration retornará informações sobre todas as definições de configuração de monitoramento de integridade em uso.

Filter

Opcional

Cadeia de caracteres

Permite utilizar caracteres curinga ao se especificar as definições de configuração de monitoramento de integridade a serem recuperadas. Por exemplo, esta sintaxe retorna todas as definições configuradas no domínio litwareinc.com: -Filter "*.litwareinc.com".

LocalStore

Opcional

Parâmetro de opção

Recupera os dados de configuração de monitoramento de integridade na réplica local do Repositório de Gerenciamento Central, em vez do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma. Get-CsHealthMonitoringConfiguration não aceita a entrada canalizada.

Tipos de Retorno

Get-CsHealthMonitoringConfiguration retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.HealthMonitoring.HealthMonitoringSettings.

Exemplo

-------------------------- Exemplo 1 ------------------------

Get-CsHealthMonitoringConfiguration

O comando anterior retorna todas as definições de configuração de monitoramento de integridade em uso na organização.

-------------------------- Exemplo 2 ------------------------

Get-CsHealthMonitoringConfiguration -Identity atl-cs-001.litwareinc.com

O comando apresentado no Exemplo 2 retorna uma coleção única de definições de configuração de monitoramento de integridade: as definições que tiverem a identidade atl-cs-001.litwareinc.com.

-------------------------- Exemplo 3 ------------------------

Get-CsHealthMonitoringConfiguration -Filter *.litwareinc.com

O Exemplo 3 retorna todas as definições de configuração de monitoramento de integridade que tiverem sido criadas no domínio litwareinc.com. Para fazer isso, Get-CsHealthMonitoringConfiguration é chamado, juntamente com o parâmetro Filter; o valor de filtro "*.litwareinc.com" garante que serão retornadas apenas as definições cuja identidade terminar com o valor da cadeia de caracteres ".litwareinc.com".

-------------------------- Exemplo 4 ------------------------

Get-CsHealthMonitoringConfiguration | Where-Object {$_.FirstTestUserSipUri -eq "sip:kenmyer@litwareinc.com" -or $_.SecondTestUserSipUri -eq " sip:kenmyer@litwareinc.com"}

O comando apresentado no Exemplo 4 retorna todas as definições de configuração de monitoramento de integridade que incluírem o usuário com o endereço SIP sip:kenmyer@litwareinc.com como um dos usuários de teste. Para realizar essa tarefa, o comando chama primeiramente Get-CsHealthMonitoringConfiguration sem nenhum parâmetro adicional, que retorna uma coleção de todas as definições de configuração de monitoramento de integridade em uso na organização. Esta coleção será então canalizada para o cmdlet Where-Object, que selecionará apenas as definições cuja propriedade FirstTestUserSipUri for igual a "sip:kenmyer@litwareinc.com" ou cuja propriedade SecondTestUserSipUri for igual a "sip:kenmyer@litwareinc.com". Como resultado, será retornada qualquer coleção de definições nas quais o endereço SIP Ken Myer for utilizado para o primeiro ou segundo usuário de teste.