Test-CsRegistration
Tópico modificado em: 2012-03-26
Testa a capacidade de um usuário fazer logon no Microsoft Lync Server 2010. Test-CsRegistration é uma "transação sintética": uma simulação de atividades comuns do Lync Server 2010 para monitoramento de integridade e desempenho.
Sintaxe
Test-CsRegistration -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-UserSipAddress <String>]
Test-CsRegistration [-TargetFqdn <String>] -UserCredential <PSCredential> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Descrição Detalhada
Test-CsRegistration é um exemplo de uma "transação sintética" do Lync Server. As transações sintéticas são usadas no Lync Server 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 costumam ser conduzidas de duas maneiras diferentes. Muitos administradores vão usar os cmdlets CsHealthMonitoringConfiguration para configurar usuários de teste para cada um de seus pools de Registrador. Esses usuários de teste são um par de usuários pré-configurados para uso com transações sintéticas (geralmente, são contas de testes, e não contas que pertençam a usuários reais). Com contas de usuário de testes configuradas para um pool, os administradores podem simplesmente executar uma transação sintética nesse pool sem ter que especificar as identidades (e fornecer as credenciais) das contas de usuário envolvidas no teste.
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 poderia 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) para tentar diagnosticar e resolver o problema. Se optar por conduzir uma transação sintética usando contas de usuário reais, será necessário fornecer os nomes de logon e as senhas de cada usuário.
O cmdlet Test-CsRegistration permite verificar se os usuários da sua organização podem fazer logon no Lync Server. Para realizar essa verificação, Test-CsRegistration exige uma única conta de teste. Se usuários de teste foram configurados para o pool no qual o teste será conduzido, não será necessário especificar uma conta; em vez disso, Test-CsRegistration usará automaticamente a primeira conta de teste atribuída ao pool. (para detalhes, consulte o tópico de Ajuda New-CsHealthMonitoringConfiguration). Uma alternativa é conduzir o teste usando uma conta que não tenha sido atribuída ao pool. Isso permitirá executar testes, mesmo se você não tiver configurado usuários de teste. Também permite testar a capacidade de um usuário específico de fazer logon no Lync Server. (se optar por esta abordagem, será preciso fornecer o nome de usuário e a senha da conta que está sendo testada).
Ao executar Test-CsRegistration, o cmdlet tenta fazer logon do usuário de teste no Lync Server e, se tiver êxito, desconecta esse usuário de teste do sistema. Tudo isso acontece sem a interação do usuário, e sem afetar os usuários reais. Por exemplo, suponhamos que a conta de teste sip:kenmyer@litwareinc.com corresponda a um usuário real com uma conta real do Lync Server. Nesse caso, o teste será conduzido sem prejuízo algum ao verdadeiro Ken Myer. Quando a conta de teste de Ken Myer fizer logoff do sistema, a pessoa Ken Myer continuará conectada.
Com o parâmetro Verbose é possível obter um relato detalhado de todas as ações realizadas por Test-CsRegistration para a conclusão de seu teste.
Quem pode executar este cmdlet: 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 "Test-CsRegistration"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
TargetFqdn |
Obrigatório |
Cadeia de caracteres |
O FQDN (nome de domínio totalmente qualificado) do pool a ser testado. |
OutVerboseVariable |
Opcional |
Cadeia de caracteres |
Quando presente, a saída detalhada da execução do cmdlet será armazenada na variável especificada. Por exemplo, para armazenar a saída em uma variável denominada $TestOutput, use a seguinte sintaxe: -OutVerboseVariable TestOutput Não use um caractere $ como prefixo ao especificar o nome da variável. |
RegistrarPort |
Opcional |
Inteiro |
Porta SIP usada pelo serviço Registrador. Esse parâmetro não será necessário se o Registrador usar a porta padrão 5061. |
UserCredential |
Opcional |
Objeto de credencial PS |
Objeto de credencial de usuário para a conta a ser testada. O valor passado para UserCredential deve ser uma referência de objeto obtida com o cmdlet Get-Credential. Por exemplo, este código retorna um objeto de credencial para o usuário litwareinc\kenmyer e armazena esse objeto em uma variável chamada $x: $x = Get-Credential "litwareinc\kenmyer" É preciso fornecer a senha de usuário ao executar este comando. Esse parâmetro não será necessário se você estiver conduzindo o teste sob a configuração de monitoramento de integridade do pool. |
UserSipAddress |
Opcional |
Endereço SIP |
O endereço SIP da conta de usuário a ser testada; por exemplo: -UserSipAddress "sip:kenmyer@litwareinc.com". O parâmetro UserSipAddress precisa fazer referência à mesma conta de usuário que UserCredential. Esse parâmetro não será necessário se você estiver conduzindo o teste sob a configuração de monitoramento de integridade do pool. |
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. |
Verbose |
Opcional |
Parâmetros de opção |
Relata atividade detalhada na tela enquanto o cmdlet é executado. |
Tipos de Entrada
Nenhuma. Test-CsRegistration não aceita entrada em pipeline.
Tipos de Retorno
Test-CsRegistration retorna uma instância do objeto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Exemplo
-------------------------- Exemplo 1 --------------------------
Test-CsRegistration -TargetFqdn atl-cs-001.litwareinc.com
O exemplo anterior testa o serviço Registrador para o pool atl-cs-001.litwareinc.com. Esse comando só funcionará se usuários de teste tiverem sido definidos no pool atl-cs-001.litwareinc.com. Se eles tiverem sido definidos, o comando irá determinar se o primeiro usuário de teste é capaz de fazer logon no Lync Server.
Se usuários de testes não tiverem sido definidos, o comando irá falhar porque não vai saber qual usuário empregar para fazer logon. Se nenhum usuário de teste tiver sido definido para um pool, será preciso incluir o parâmetro UserSipAddress e as credenciais do usuário que o comando deve usar ao tentar fazer logon.
-------------------------- Exemplo 2 --------------------------
$cred1 = Get-Credential "litwareinc\pilar"
Test-CsRegistration -TargetFqdn atl-cs-001.litwareinc.com -UserCredential $cred1 -UserSipAddress "sip:pilar@litwareinc.com"
Os comandos mostrados no Exemplo 2 testam a capacidade de um usuário específico (litwareinc\pilar) de fazer logon no Lync Server. Para fazer isso, o primeiro comando do exemplo usa o cmdlet Get-Credential para criar um objeto de credencial do Windows PowerShell contendo o nome e a senha da usuária Pilar Ackerman (como o nome de logon litwareinc\pilar foi incluído como parâmetro, a caixa de diálogo Solicitação de Credenciais do Windows PowerShell só exigirá que o administrador digite a senha da conta de Pilar Ackerman). O objeto de credencial resultante é então armazenado em uma variável chamada $cred1.
Em seguida, o segundo comando verifica se esse usuário pode fazer logon no pool atl-cs-001.litwareinc.com. Para realizar essa tarefa, Test-CsRegistration é chamado, com três parâmetros: TargetFqdn (o FQDN do pool do Registrador); UserCredential (o objeto do Windows PowerShell que contém as credenciais da usuária Pilar Ackerman); e UserSipAddress (o endereço SIP correspondente às credenciais de usuário fornecidas).