Testando a capacidade de mensagens instantâneas entre dois usuários no Lync Server 2013Testing ability to IM between two users in Lync Server 2013

 

Última modificação do tópico: 2014-06-05Topic Last Modified: 2014-06-05

Agenda de verificaçãoVerification schedule

DiariamenteDaily

Ferramenta de testeTesting tool

Windows PowerShellWindows PowerShell

Permissões obrigatóriasPermissions required

Ao executar localmente usando o Shell de gerenciamento do Lync Server, os usuários devem ser membros do grupo de segurança RTCUniversalServerAdmins.When run locally using the Lync Server Management Shell, users must be members of the RTCUniversalServerAdmins security group.

Quando executado 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.When run using a remote instance of Windows PowerShell, users must be assigned an RBAC role that has permission to run the Test-CsIM cmdlet. Para ver uma lista de todas as funções RBAC que podem usar este cmdlet, execute o seguinte comando no prompt do Windows PowerShell:To see a list of all RBAC roles that can use this cmdlet, run the following command from the Windows PowerShell prompt:

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

DescriçãoDescription

O cmdlet Test-CsIM verifica se um par de usuários de teste podem trocar mensagens instantâneas.The Test-CsIM cmdlet verifies that a pair of test users can exchange instant messages. Quando chamado, o cmdlet Test-CsIM começa tentando fazer logon em um par de usuários de teste no Lync Server.When called, the Test-CsIM cmdlet starts off by trying to log on a pair of test users to Lync Server. Supondo que os dois logons sejam bem-sucedidos, o cmdlet iniciará uma sessão de IM entre os dois usuários de teste.Assuming the two logons are successful, the cmdlet then starts an IM session between the two test users. (O usuário 1 convida o usuário 2 para uma sessão de IM e o usuário 2 aceita o convite.) Após verificar que as mensagens podem ser trocadas entre os dois usuários, Test-CsIM, em seguida, encerra a sessão de mensagens instantâneas e registra os dois usuários fora do sistema.(User 1 invites User 2 to an IM session, and User 2 accepts the invitation.) After verifying that messages can be exchanged between the two users, Test-CsIM then ends the IM session and logs both users off the system.

Para obter mais informações, consulte a documentação de ajuda para o cmdlet Test-CsIM .For more information, see the Help documentation for the Test-CsIM cmdlet.

Executar o testeRunning the Test

O cmdlet Test-CsIM pode ser executado usando um par de contas de teste pré-configuradas (Confira Configurando contas de teste para executar testes do Lync Server) ou as contas de dois usuários que estão habilitados para o Lync Server.The Test-CsIM cmdlet can be run using either a pair of preconfigured test accounts (see Setting Up Test Accounts for Running Lync Server Tests) or the accounts of any two users who are enabled for Lync Server. Para executar essa verificação usando contas de teste, basta especificar o FQDN do pool do Lync Server que está sendo testado.To run this check using test accounts, you just have to specify the FQDN of the Lync Server pool being tested. Por exemplo:For example:

Test-CsIM -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 Windows PowerShell (objetos que contêm o nome da conta e a senha) para cada conta.To run this check using actual user accounts, you must create two Windows PowerShell credentials objects (objects that contain the account name and password) for each account. Em seguida, você deve incluir esses objetos de credenciais e os endereços SIP das duas contas ao chamar Test-CsIM:You must then include those credentials objects and the SIP addresses of the two accounts when you call 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 de ajuda para o cmdlet Test-CsIM .For more information, see the Help documentation for the Test-CsIM cmdlet.

Determinando o sucesso ou a falhaDetermining Success or Failure

Se os dois usuários podem concluir uma sessão de mensagens instantâneas, você receberá uma saída semelhante a essa, com a propriedade Result marcada como Success:If the two users can complete an instant messaging session, you'll receive output similar to this, with the Result property marked as Success:

TargetFqdn: atl-cs-001.litwareinc.comTargetFqdn : atl-cs-001.litwareinc.com

Resultado: êxitoResult : Success

Latência: 00:00:06.6630911Latency : 00:00:06.6630911

ErrosError :

DiagnósticoDiagnosis :

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 de erro e diagnóstico:If the test users can't complete the session, the Result will be shown as Failure, and additional information will be recorded in the Error and Diagnosis properties:

TargetFqdn: atl-cs-001.litwareinc.comTargetFqdn : atl-cs-001.litwareinc.com

Resultado: falhaResult : Failure

Latência: 00:00:00Latency : 00:00:00

Erro: 504, tempo limite do servidorError : 504, Server time-out

Diagnóstico: ErrorCode = 2, Source = ATL-cs-001. litwareinc. com, razão = ConfiraDiagnosis : ErrorCode=2, Source=atl-cs-001.litwareinc.com,Reason=See

código de resposta e frase de motivo.response code and reason phrase.

Microsoft. RTC. Signaling. DiagnosticHeaderMicrosoft.Rtc.Signaling.DiagnosticHeader

Por exemplo, a saída anterior diz que o teste falhou porque o usuário especificado não pôde ser encontrado.For example, the previous output states that the test failed because the specified user couldn't be found. Você pode determinar se um endereço SIP é válido (e se o usuário atribuído ao endereço SIP foi habilitado para o Lync Server) executando este comando:You can determine whether a SIP address is valid (and whether the user assigned that SIP address was enabled for Lync Server) by running this command:

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 Verbose:If Test-CsIM fails, then you might want to rerun the test, this time including the Verbose parameter:

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

Quando o parâmetro Verbose é incluído, Test-CsIM retornará uma conta passo a passo de cada ação que tentou quando verificou a capacidade dos dois usuários de teste participarem da sessão de IM.When the Verbose parameter is included, Test-CsIM will return a step-by-step account of each action it tried when it checked the ability of the two test users to take part in an IM session. Por exemplo, veja a seguir um exemplo de saída que ocorre quando um conjunto incorreto de credenciais de usuário (neste caso, uma senha incorreta) é fornecido para Test-CsIM:For example, here’s sample output that occurs when an incorrect set of user credentials (in this case, an incorrect password) is supplied to Test-CsIM:

Enviando solicitação de registro:Sending Registration request :

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

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

Porta do registrador = 5061Registrar Port = 5061

O tipo de autenticação ' IWA ' é selecionado.Auth Type 'IWA' is selected.

Acerto de registro em relação ao SIP/ATL-cs-001. litwareinc. comRegistration hit against sip/atl-cs-001.litwareinc.com

Atividade ' Register ' concluída em ' 0, 601795 ' segundos.'Register' activity completed in '0.0601795' secs.

Uma exceção ' o logon foi negado.An exception 'The log on was denied. Verifique se as credenciais corretas estão sendo usadas e se a conta está ativa.Check that the correct credentials are being used and the account is active.' ocorrido durante o fluxo de trabalho.occurred during the Workflow.

Motivos pelos quais o teste pode ter falhadoReasons Why the Test Might Have Failed

Aqui estão alguns motivos comuns para que Test-CsIM possa falhar:Here are some common reasons why Test-CsIM might fail:

  • Você especificou uma conta de usuário que não é válida.You specified a user account that is not valid. Você pode verificar se uma conta de usuário existe executando um comando semelhante a este:You can verify that a user account exists by running a command similar to this:

    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.The user account is valid, but the account is currently not enabled for Lync Server. Para verificar se uma conta de usuário está habilitada para o Lync Server, execute um comando semelhante ao seguinte:To verify that a user account is enabled for Lync Server, run a command similar to the following:

    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 para o Lync Server no momento.If the Enabled property is set to False that means that the user is currently not enabled for Lync Server.

  • O serviço de mensagens instantâneas pode não estar disponível.The instant messaging service might not be available. Com o Lync Server, você pode configurar o sistema para que o IM não fique disponível se o banco de dados de arquivamento não puder ser acessado.With Lync Server, you can configure the system so that IM is not available if the archiving database cannot be accessed. Você pode verificar se está executando um comando semelhante ao seguinte:You can verify that by running a command similar to the following:

    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.If BlockOnArchiveFailure is set to True, then you should determine whether or not the archiving database is available. Você pode retornar os locais dos seus bancos de dados de arquivamento usando o seguinte comando:You can return the locations of your archiving databases by using the following command:

    Get-CsService -ArchivingDatabase
    
  • O servidor de arquivamento pode não estar disponível.The Archiving server might not be available. Você pode recuperar o FQDN dos seus servidores de arquivamento usando este comando:You can retrieve the FQDN of your Archiving servers by using this command:

    Get-CsService -ArchivingServer
    

    Você pode fazer o ping no servidor apropriado para verificar se ele está disponível.You can then ping the appropriate server to verify that it is available. Por exemplo:For example:

    ping atl-archiving-001.litwareinc.com