Testar a capacidade de fazer mensagens instantâneas de grupo no Lync Server 2013

 

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-CsGroupIM 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-CsGroupIM"}

Descrição

O Test-CsGroupIM cmdlet verifica se os usuários em sua organização podem realizar sessões de mensagens instantâneas de grupo. Quando você executa Test-CsGroupIM, o cmdlet tenta conectar um par de usuários de teste ao Lync Server. Se tiver êxito, Test-CsGroupIM criará uma nova conferência usando o primeiro usuário de teste e, em seguida, convidará o segundo usuário para ingressar na conferência. Após uma troca de mensagens, ambos os usuários são desconectados do sistema. Observe que tudo isso acontece sem nenhuma interação do usuário e sem afetar nenhum usuário real. Por exemplo, suponha que a conta de teste sip:kenmyer@litwareinc.com corresponde a um usuário real que tem uma conta real do Lync Server. Nesse caso, o teste será realizado sem nenhuma interrupção no verdadeiro Ken Myer. Por exemplo, mesmo quando a conta de teste de Ken Myer fizer logoff do sistema, Ken Myer, a pessoa permanecerá conectada. Da mesma forma, o verdadeiro Ken Myer não receberá um convite para participar da conferência. Esse convite será enviado e aceito pela conta de teste.

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

Executando o teste

O cmdlet Test-CsGroupIM 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-CsGroupIM -TargetFqdn "atl-cs-001.litwareinc.com"

Para executar essa verificação usando contas de usuário reais, você deve criar dois objetos de credenciais do Shell de Gerenciamento do Lync Server (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-CsGroupIM:

$credential1 = Get-Credential "litwareinc\kenmyer"
$credential2 = Get-Credential "litwareinc\davidlongmire"
Test-CsGroupIm -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-CsGroupIM .

Determinando êxito ou falha

Se os dois usuários puderem concluir uma sessão de mensagens instantâneas de grupo, 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.3812203

Erro:

Diagnóstico:

Se os dois usuários não puderem concluir a sessão de mensagens instantâneas, 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: 404, Não Encontrado

Diagnóstico: ErrorCode=4005,Source=atl-cs-001.litwareinc.com,

Reason=Destination URI não está habilitado para SIP ou não

Existe.

Microsoft.Rtc.Signaling.DiagnosticHeader

A saída anterior afirma que o teste falhou porque pelo menos uma das contas de teste não era válida, seja porque a conta não existe ou porque o usuário não foi habilitado para o Lync Server. Você pode verificar se a conta existe e se a conta foi ou não habilitada para nm-ocs-14-3rd executando um comando semelhante a este:

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

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

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

Quando o parâmetro Detalhado for incluído, o Test-CsGroupIM retornará uma conta passo a passo de cada ação que tentou ao verificar a capacidade dos usuários especificados de participar de uma sessão de mensagens instantâneas de grupo. Por exemplo, se o teste falhar e você for informado de que uma ou mais das contas de usuário não são válidas, você poderá executar novamente o teste usando o parâmetro Detalhado e determinar qual conta de usuário não é válida:

Solicitação de registro de envio:

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

 Endereço SIP do usuário = sip:kenmyer@litwareinc.com

 Registrar Porta = 5061

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

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

Como você pode ver, neste exemplo, o usuário que tem o sip de endereço SIP:kenmyer@litwareinc.com não pôde fazer logon.

Motivos pelos quais o teste pode ter falhado

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

  • Você especificou uma conta de usuário incorreta. 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 foi habilitada para o Lync Server, execute um comando semelhante ao seguinte:

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

    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 o sistema de mensagens instantâneas 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 de seus 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