Compartilhar via

  • Artigo

New-CsHealthMonitoringConfiguration

 

Tópico modificado em: 2012-03-26

Cria uma nova coleção de configurações de monitoramento de integridade para uso em sua organização. Essas configurações permitem que administradores executem testes de controle de qualidade sem ter que fornecer os nomes de usuários e senhas das contas de testes necessárias.

Sintaxe

New-CsHealthMonitoringConfiguration -Identity <XdsGlobalRelativeIdentity> -FirstTestUserSipUri <String> -SecondTestUserSipUri <String> [-Confirm [<SwitchParameter>]] [-FirstTestSamAccountName <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-SecondTestSamAccountName <String>] [-WhatIf [<SwitchParameter>]]

New-CsHealthMonitoringConfiguration -FirstTestUserSipUri <String> -SecondTestUserSipUri <String> -TargetFqdn <String> [-Confirm [<SwitchParameter>]] [-FirstTestSamAccountName <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-SecondTestSamAccountName <String>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

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

Transações sintéticas podem ser conduzidas de duas maneiras diferentes. Muitos administradores vão usar os cmdlets CsHealthMonitoringConfiguration para configurar contas de teste para cada um de seus pools de Registrador. Essas contas de teste são um par de contas de usuários pré-configuradas para uso com transações sintéticas (geralmente, são contas de testes, e não contas que pertençam a usuários reais). Quando essas contas de teste são configuradas para um pool, os administradores podem executar uma transação sintética contra este pool, sem ter que especificar as identidades das (e fornecer as credenciais para) contas de usuário envolvidas no teste. Em vez disso, a transação sintética usará automaticamente as contas de testes pré-configuradas ao realizar suas verificações.

Outra opção para os administradores é a de executar uma transação sintética com contas de usuário reais. Por exemplo, se dois usuários não conseguirem trocar mensagens instantâneas, um administrador pode executar uma transação sintética usando as duas contas de usuário em questão (em vez de um par de contas de testes). Se optar por conduzir uma transação sintética usando contas de usuário reais, será necessário fornecer as credenciais de cada usuário.

O cmdlet New-CsHealthMonitoringConfiguration proporciona uma maneira de criar uma nova configuração de monitoramento de integridade para um pool de Registrador ou Diretor. Ao criar uma nova coleção de configurações de monitoramento de integridade, você deve especificar o FQDN (nome de domínio totalmente qualificado) do pool, além dos endereços SIP das duas contas que servirão como contas de testes do pool. (no entanto, não é preciso fornecer as senhas dessas contas de testes). Observe que cada pool pode hospedar no máximo uma única coleção de configurações de monitoramento de integridade. O comando irá falhar se você tentar criar uma nova coleção para o pool atl-cs-001.litwareinc.com e esse pool já tiver sido atribuído a um Registrador.

Você pode receber um aviso ao executar New-CsHealthMonitoringConfiguration se tiver pools que não tenham sido atribuídos a usuários de teste; isso pode incluir pools de Diretor e pools do Office Communications Server. Esses avisos podem ser ignorados. Se preferir, você pode atribuir usuários de teste hospedados em outros pools aos seus pools de Diretor; assim, você poderia executar o cmdlet Test-CsRegistration no Diretor. No entanto, usuários de teste não podem ser atribuídos a pools do Office Communications Server.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet New-CsHealthMonitoringConfiguration localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

FQDN

O FQDN do pool no qual as configurações de monitoramento de integridade serão atribuídas (por exemplo: -Identity atl-cs-001.litwareinc.com). O comando irá falhar se o pool especificado já hospedar uma coleção de configurações de monitoramento de integridade.

O parâmetro Identity é equivalente ao parâmetro TargetFqdn. Ao criar uma nova coleção de configurações, é possível usar qualquer um dos dois parâmetros. Se nenhum dos dois for especificado, New-CsHealthMonitoringConfiguration pedirá uma identidade.

TargetFqdn

Opcional

FQDN

O FQDN do pool no qual as configurações de monitoramento de integridade serão atribuídas (por exemplo: -TargetFqdn atl-cs-001.litwareinc.com). O comando irá falhar se o pool especificado já hospedar uma coleção de configurações de monitoramento de integridade.

O parâmetro TargetFqdn é equivalente ao parâmetro Identity. Ao criar uma nova coleção de configurações, é possível usar qualquer um dos dois parâmetros. Se nenhum dos dois for especificado, New-CsHealthMonitoringConfiguration pedirá uma identidade.

FirstTestSamAccountName

Opcional

Cadeia de caracteres

SamAccountName do primeiro usuário de teste. O FirstTestSamAccountName deve ser digitado no formato domínio\nomedeusuário; por exemplo:

-FirstTestSamAccountName litwareinc\kenmyer

FirstTestUserSipUri

Opcional

Endereço SIP

Endereço SIP do primeiro usuário de teste a ser configurado para uso pela coleção de configurações de monitoramento de integridade. Observe que o endereço SIP deve incluir o prefixo sip: Por exemplo: -FirstTestUserSipUri "sip:kenmyer@litwareinc.com".

SecondTestSamAccountName

Opcional

Cadeia de caracteres

SamAccountName do segundo usuário de teste. O SecondTestSamAccountName deve ser digitado no formato domínio\nomedeusuário; por exemplo:

-SecondTestSamAccountName litwareinc\pilar

SecondTestUserSipUri

Opcional

Endereço SIP

Endereço SIP do segundo usuário de teste a ser configurado para uso pela coleção de configurações de monitoramento de integridade. Observe que o endereço SIP deve incluir o prefixo sip: Por exemplo: -SecondTestUserSipUri "sip:pilar@litwareinc.com".

Force

Opcional

Parâmetros de opção

Suprime a exibição de mensagens de erro não fatais que possam ocorrer na execução do comando.

InMemory

Opcional

Parâmetros de opção

Cria uma referência de objeto, sem na verdade executar o objeto como uma alteração permanente. Se a saída deste cmdlet for atribuída, chamando-o com este parâmetro a uma variável, você poderá realizar alterações às propriedades da referência do objeto e executar estas alterações, chamando-se o cmdlet coincidente Set- deste cmdlet.

WhatIf

Opcional

Parâmetros de opção

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Opcional

Parâmetros de opção

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Nenhuma. New-CsHealthMonitoringConfiguration não aceita entrada em pipeline.

Tipos de Retorno

New-CsHealthMonitoringConfiguration cria novas instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.HealthMonitoring.HealthMonitoringSettings.

Exemplo

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

New-CsHealthMonitoringConfiguration -Identity atl-cs-001.litwareinc.com -FirstTestUserSipUri "sip:kenmyer@litwareinc.com" -SecondTestUserSipUri "sip:pilar@litwareinc.com"

O comando mostrado no Exemplo 1 cria uma nova coleção de configurações de monitoramento de integridade para o pool atl-cs-001.litwareinc.com. Essas novas configurações usarão sip:kenmyer@litwareinc.com e sip:pilar@litwareinc.com como as contas de teste pré-configuradas.

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

$x = Get-CsService -Registrar | Select-Object PoolFqdn
foreach ($i in $x)
   {New-CsHealthMonitoringConfiguration -Identity $i.PoolFqdn -FirstTestUserSipUri "sip:kenmyer@litwareinc.com" -SecondTestUserSipUri "sip:pilar@litwareinc.com"}

O Exemplo 2 cria uma nova coleção de configurações de monitoramento de integridade para todos os pools de Registrador da organização. Para isso, o primeiro comando do exemplo usa o cmdlet Get-Service e o parâmetro Registrar para retornar uma coleção de todos os pools de Registrador. Esta coleção é então canalizada para o cmdlet Select-Object, que seleciona apenas a propriedade PoolFqdn (esta propriedade retorna o FQDN de um pool de Registrador). Esses FQDNs são armazenados em uma variável chamada $x.

No segundo comando, um loop foreach é criado para executar um loop em cada FQDN de pool de Registrador. Para cada FQDN, New-CsHealthMonitoringConfiguration é chamado para criar uma nova coleção de configurações, com o FQDN armazenado em $x usado como Identidade para a nova coleção. Cada coleção também é atribuída às mesmas duas contas de teste: sip:kenmyer@litwareinc.com e sip:pilar@litwareinc.com.