Testar a capacidade de mensagens instantâneas entre dois usuários no Lync Server 2013

  • Artigo

 

Tópico Última Modificação: 05/06/2014

Agendamento de verificação

Diário

Ferramenta de teste

Windows PowerShell

Permissões necessárias

Quando executados localmente usando o Shell de Gerenciamento do Lync Server, os usuários devem ser membros do grupo de segurança RTCUniversalServerAdmins.

Ao executar usando uma instância remota do Windows PowerShell, os usuários devem receber uma função RBAC que tenha permissão para executar o cmdlet Test-CsIM aplicativo. Para ver uma lista de todas as funções RBAC que podem usar esse cmdlet, execute o seguinte comando Windows PowerShell prompt:

Get-CsAdminRole | Where-Object {$_.Cmdlets -match "Test-CsIM"}

Descrição

O Test-CsIM cmdlet verifica se um par de usuários de teste pode trocar mensagens instantâneas. Quando chamado, o Test-CsIM cmdlet inicia tentando fazer logon em um par de usuários de teste no Lync Server. Supondo que os dois logons sejam bem-sucedidos, o cmdlet iniciará uma sessão de mensagens instantâneas entre os dois usuários de teste. (O usuário 1 convida o Usuário 2 para uma sessão de mensagens instantâneas e o Usuário 2 aceita o convite.) Depois de verificar se as mensagens podem ser trocadas entre os dois usuários, o Test-CsIM encerra a sessão de mensagens instantâneas e registra os dois usuários fora do sistema.

Para obter mais informações, consulte a documentação da Ajuda para o cmdlet Test-CsIM .

Executando o teste

O cmdlet Test-CsIM pode ser executado usando um par de contas de teste pré-configuradas (consulte Configurando contas de teste para executar testes do Lync Server) ou as contas de dois usuários habilitados para o Lync Server. Para executar essa verificação usando contas de teste, basta especificar o FQDN do pool do Lync Server que está sendo testado. Por exemplo:

Test-CsIM -TargetFqdn "atl-cs-001.litwareinc.com"

Para executar essa verificação usando contas de usuário reais, você deve criar dois Windows PowerShell de credenciais (objetos que contêm o nome da conta e a senha) para cada conta. Em seguida, você deve incluir esses objetos de credenciais e os endereços SIP das duas contas ao chamar Test-CsIM:

$credential1 = Get-Credential "litwareinc\kenmyer"
$credential2 = Get-Credential "litwareinc\davidlongmire"
Test-CsIm -TargetFqdn "atl-cs-001.litwareinc.com" -SenderSipAddress "sip:kenmyer@litwareinc.com" -SenderCredential $credential1 -ReceiverSipAddress "sip:davidlongmire@litwareinc.com" -ReceiverCredential $credential2

Para obter mais informações, consulte a documentação da Ajuda para o cmdlet Test-CsIM .

Determinando êxito ou falha

Se os dois usuários puderem concluir uma sessão de mensagens instantâneas, você receberá uma saída semelhante a esta, com a propriedade Result marcada como Êxito:

TargetFqdn : atl-cs-001.litwareinc.com

Resultado: Êxito

Latência: 00:00:06.6630911

Erro:

Diagnóstico:

Se os usuários de teste não puderem concluir a sessão, o resultado será mostrado como Falha e informações adicionais serão registradas nas propriedades Erro e Diagnóstico:

TargetFqdn : atl-cs-001.litwareinc.com

Resultado: falha

Latência: 00:00:00

Erro: 504, Tempo limite do servidor

Diagnóstico: ErrorCode=2, Source=atl-cs-001.litwareinc.com,Reason=See

código de resposta e frase de motivo.

Microsoft.Rtc.Signaling.DiagnosticHeader

Por exemplo, a saída anterior afirma que o teste falhou porque o usuário especificado não pôde ser encontrado. Você pode determinar se um endereço SIP é válido (e se o usuário atribuído a esse endereço SIP foi habilitado para o Lync Server) executando este comando:

Get-CsUser "Ken Myer" | Select-Object SipAddress, Enabled

Se Test-CsIM falhar, talvez você queira executar novamente o teste, desta vez incluindo o parâmetro Detalhado:

Test-CsIM -TargetFqdn "atl-cs-001.litwareinc.com" -Verbose

Quando o parâmetro Detalhado for incluído, o Test-CsIM retornará uma conta passo a passo de cada ação que tentou ao verificar a capacidade dos dois usuários de teste de participar de uma sessão de mensagens instantâneas. Por exemplo, aqui está uma saída de exemplo que ocorre quando um conjunto incorreto de credenciais de usuário (nesse caso, uma senha incorreta) é fornecido para Test-CsIM:

Solicitação de registro de envio:

Fqdn de destino = atl-cs-011.litwareinc.com

Endereço Sip do Usuário = sip:kenmyer@litwareinc.com

Porta do Registrador = 5061

O tipo de autenticação 'IWA' está selecionado.

Ocorrência de registro em sip/atl-cs-001.litwareinc.com

Atividade 'Registrar' concluída em '0,0601795' segundos.

Uma exceção "O logon foi negado. Verifique se as credenciais corretas estão sendo usadas e se a conta está ativa.' ocorreu durante o Fluxo de Trabalho.

Motivos pelos quais o teste pode ter falhado

Aqui estão alguns motivos comuns pelos quais Test-CsIM pode falhar:

  • Você especificou uma conta de usuário que não é válida. Você pode verificar se uma conta de usuário existe executando um comando semelhante a este:

    Get-CsUser "sip:kenmyer@litwareinc.com"

  • A conta de usuário é válida, mas a conta não está habilitada no momento para o Lync Server. Para verificar se uma conta de usuário está habilitada para o Lync Server, execute um comando semelhante ao seguinte:

    Get-CsUser "sip:kenmyer@litwareinc.com" | Select-Object Enabled

    Se a propriedade Enabled estiver definida como False, isso significa que o usuário não está habilitado no momento para o Lync Server.

  • O serviço de mensagens instantâneas pode não estar disponível. Com o Lync Server, você pode configurar o sistema para que a mensagem instantânea não esteja disponível se o banco de dados de arquivamento não puder ser acessado. Você pode verificar isso executando um comando semelhante ao seguinte:

    Get-CsArchivingConfiguration -Identity "atl-cs-001.litwareinc.com" | Select-Object BlockOnArchiveFailure

    Se BlockOnArchiveFailure estiver definido como True, você deverá determinar se o banco de dados de arquivamento está disponível ou não. Você pode retornar os locais dos bancos de dados de arquivamento usando o seguinte comando:

    Get-CsService -ArchivingDatabase

  • O servidor de Arquivamento pode não estar disponível. Você pode recuperar o FQDN dos servidores de Arquivamento usando este comando:

    Get-CsService -ArchivingServer

    Em seguida, você pode executar ping no servidor apropriado para verificar se ele está disponível. Por exemplo:

    ping atl-archiving-001.litwareinc.com