Testando a capacidade de realizar o grupo de IM no Lync Server 2013Testing ability to do group IM 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-CsGroupIM.When run using a remote instance of Windows PowerShell, users must be assigned an RBAC role that has permission to run the Test-CsGroupIM 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-CsGroupIM"}

DescriçãoDescription

O cmdlet Test-CsGroupIM verifica se os usuários da sua organização podem realizar sessões de mensagens instantâneas de grupo.The Test-CsGroupIM cmdlet verifies that users in your organization can conduct group instant messaging sessions. Quando você executa o Test-CsGroupIM, o cmdlet tenta entrar em um par de usuários de teste para o Lync Server.When you run Test-CsGroupIM, the cmdlet attempts to sign in a pair of test users to Lync Server. Se houver ê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.If successful, Test-CsGroupIM creates a new conference using the first test user, then invites the second user to join the conference. Depois de uma troca de mensagens, ambos os usuários são desconectados do sistema.After an exchange of messages, both users are then disconnected from the system. Observe que tudo isso ocorre sem qualquer interação do usuário e sem afetar os usuários reais.Note that all of this happens without any user interaction, and without affecting any actual users. 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.For example, suppose that the test account sip:kenmyer@litwareinc.com corresponds to a real user who has a real Lync Server account. Nesse caso, o teste será realizado sem nenhuma interrupção para o Ken Myer real.In that case, the test will be conducted without any disruption to the real Ken Myer. Por exemplo, mesmo quando a conta de teste Ken Myer fizer logoff do sistema, a pessoa Ken Myer permanecerá conectada.For example, even when the Ken Myer test account logs off from the system, Ken Myer the person will remain logged on. Da mesma forma, o verdadeiro Ken Myer não receberá um convite para ingressar na conferência.Likewise, the real Ken Myer won't receive an invitation to join the conference. Esse convite será enviado para e aceito pela conta de teste.That invitation will be sent to, and accepted by, the test account.

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

Executar o testeRunning the test

O cmdlet Test-CsGroupIM 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-CsGroupIM 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-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.To run this check using actual user accounts, you must create two Lync Server Management Shell 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-CsGroupIM:You must then include those credentials objects and the SIP addresses of the two accounts when you call 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 de ajuda para o cmdlet Test-CsGroupIM .For more information, see the Help documentation for the Test-CsGroupIM cmdlet.

Determinando o sucesso ou a falhaDetermining Success or Failure

Se os dois usuários podem concluir uma sessão de mensagens instantâneas de grupo, você receberá uma saída semelhante a essa, com a propriedade Result marcada como Success:If the two users can complete a group 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.3812203Latency : 00:00:06.3812203

ErrosError :

DiagnósticoDiagnosis :

Se os dois usuários não puderem concluir a sessão de mensagens instantâneas, o resultado será mostrado como falha e as informações adicionais serão registradas nas propriedades de erro e diagnóstico:If the two users can't able to complete the instant messaging session, then 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: 404, não encontradoError : 404, Not Found

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

Razão = o URI de destino não está habilitado para SIP ou nãoReason=Destination URI either not enabled for SIP or does not

existente.exist.

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

A saída anterior diz que o teste falhou porque pelo menos uma das contas de teste não era válida porque a conta não existe ou porque o usuário não foi habilitado para o Lync Server.The previous output states that the test failed because at least one of the test accounts was not valid, either because the account does not exist or because the user has not been enabled for Lync Server. Você pode verificar se a conta existe e se a conta foi habilitada para o nm-OCS-14-3ª executando um comando semelhante a este:You can verify the account exists, and whether or not the account has been enabled for nm-ocs-14-3rd by running a command similar to this:

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

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

Quando o parâmetro Verbose é incluído, Test-CsGroupIM retornará uma conta passo a passo de cada ação que tentou quando verificou a capacidade dos usuários especificados de participar de uma sessão de mensagens instantâneas de grupo.When the Verbose parameter is included, Test-CsGroupIM will return a step-by-step account of each action it tried when it checked the ability of the specified users to participate in a group instant messaging sessions. Por exemplo, se o teste falhar e você for informado de que uma ou mais contas de usuário não são válidas, você pode executar novamente o teste usando o parâmetro Verbose e determinar qual conta de usuário não é válida:For example, if your test fails and you are told that one or more of the user accounts is not valid, you can rerun the test using the Verbose parameter and determine which user account is not valid:

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

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

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

 Porta de registro = 5061Register Port    = 5061

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

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á ativaCheck that the correct credentials are being used and the account is active'

Como você pode ver, neste exemplo, o usuário com o endereço SIP sip:kenmyer@litwareinc.com não pôde fazer logon.As you can see, in this example the user who has the SIP address sip:kenmyer@litwareinc.com was not able to log on.

Motivos pelos quais o teste pode ter falhadoReasons why the test might have failed

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

  • Você especificou uma conta de usuário incorreta.You specified an incorrect user account. 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 foi habilitada para o Lync Server, execute um comando semelhante ao seguinte:To verify that a user account was enabled for Lync Server, run a command similar to the following:

    Get-CsUser "sip:kenmyer@litwareinc.com" | Select-Object habilitadoGet-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á atualmente habilitado para o Lync Server.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 sistema de mensagens instantâneas 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 instant messaging 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