Test de la fonctionnalité de groupe de messagerie instantanée dans Lync Server 2013Testing ability to do group IM in Lync Server 2013

 

Dernière modification de la rubrique : 2014-06-05Topic Last Modified: 2014-06-05

Planification de la vérificationVerification schedule

JournalièreDaily

Outil de testTesting tool

Windows PowerShellWindows PowerShell

Autorisations requisesPermissions required

Lorsqu’ils sont exécutés localement à l’aide de Lync Server Management Shell, les utilisateurs doivent être membres du groupe de sécurité RTCUniversalServerAdmins.When run locally using the Lync Server Management Shell, users must be members of the RTCUniversalServerAdmins security group.

Lorsqu’ils sont exécutés à l’aide d’une instance distante de Windows PowerShell, un rôle RBAC doit être attribué aux utilisateurs qui sont autorisés à exécuter l’applet de commande 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. Pour afficher la liste de tous les rôles RBAC pouvant utiliser cette cmdlet, exécutez la commande suivante à partir de l’invite 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"}

DescriptionDescription

L’applet de commande Test-CsGroupIM vérifie que les utilisateurs de votre organisation peuvent effectuer des sessions de messagerie instantanée de groupe.The Test-CsGroupIM cmdlet verifies that users in your organization can conduct group instant messaging sessions. Lorsque vous exécutez la cmdlet Test-CsGroupIM, l’applet de commande tente de se connecter à une paire d’utilisateurs test à Lync Server.When you run Test-CsGroupIM, the cmdlet attempts to sign in a pair of test users to Lync Server. Si l’opération réussit, Test-CsGroupIM crée une nouvelle conférence à l’aide du premier utilisateur test, puis invite le deuxième utilisateur à participer à la conférence.If successful, Test-CsGroupIM creates a new conference using the first test user, then invites the second user to join the conference. Après un échange de messages, les deux utilisateurs sont déconnectés du système.After an exchange of messages, both users are then disconnected from the system. Notez que tout cela se produit sans aucune interaction de l’utilisateur et sans affecter les utilisateurs réels.Note that all of this happens without any user interaction, and without affecting any actual users. Par exemple, supposons que le compte de test sip :kenmyer@litwareinc.com correspond à un utilisateur réel qui possède un compte de serveur Lync réel.For example, suppose that the test account sip:kenmyer@litwareinc.com corresponds to a real user who has a real Lync Server account. Dans ce cas, le test sera effectué sans interrompre les activités de l’utilisateur réel Ken Myer.In that case, the test will be conducted without any disruption to the real Ken Myer. Par exemple, même si le compte de test Ken Myer se déconnecte du système Ken Myer, l’utilisateur restera connecté.For example, even when the Ken Myer test account logs off from the system, Ken Myer the person will remain logged on. De même, le véritable Ken Myer ne reçoit pas d’invitation à participer à la Conférence.Likewise, the real Ken Myer won't receive an invitation to join the conference. Cette invitation sera envoyée au compte de test et acceptée par ce dernier.That invitation will be sent to, and accepted by, the test account.

Pour plus d’informations, reportez-vous à la documentation de l’aide relative à l’applet de commande test-CsGroupIM .For more information, see the Help documentation for the Test-CsGroupIM cmdlet.

Exécution du testRunning the test

La cmdlet Test-CsGroupIM peut être exécutée à l’aide d’une paire de comptes de test préconfigurés (voir Configuration des comptes de test pour l’exécution des tests Lync Server) ou des comptes de deux utilisateurs activés pour 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. Pour exécuter cette vérification à l’aide de comptes de test, il vous suffit de spécifier le nom de domaine complet du pool Lync Server testé.To run this check using test accounts, you just have to specify the FQDN of the Lync Server pool being tested. Par exemple :For example:

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

Pour exécuter cette vérification à l’aide de comptes d’utilisateur réels, vous devez créer deux objets d’informations d’identification Lync Server Management Shell (objets qui contiennent le nom de compte et le mot de passe) pour chaque compte.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. Vous devez ensuite inclure ces objets Credentials et les adresses SIP des deux comptes lorsque vous appelez 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

Pour plus d’informations, reportez-vous à la documentation de l’aide relative à l’applet de commande test-CsGroupIM .For more information, see the Help documentation for the Test-CsGroupIM cmdlet.

Détermination de la réussite ou de l’échecDetermining Success or Failure

Si les deux utilisateurs peuvent effectuer une session de messagerie instantanée de groupe, vous recevrez une sortie semblable à celle-ci avec la propriété Result marquée with 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

Résultat : opération réussieResult : Success

Latence : 00:00:06.3812203Latency : 00:00:06.3812203

«Error :

DiagnostiqueDiagnosis :

Si les deux utilisateurs ne peuvent pas effectuer la session de messagerie instantanée, le résultat est indiqué comme étant un échec et des informations supplémentaires sont enregistrées dans les propriétés d’erreur et de diagnostic :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

Résultat : échecResult : Failure

Latence : 00:00:00Latency : 00:00:00

Erreur : 404, introuvableError : 404, Not Found

Diagnostic : ErrorCode = 4005, source = ATL-CS-001.litwareinc.com,Diagnosis : ErrorCode=4005,Source=atl-cs-001.litwareinc.com,

Raison = l’URI de destination n’est pas activé pour SIP ou ne prend pasReason=Destination URI either not enabled for SIP or does not

présent.exist.

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

La sortie précédente indique que le test a échoué car au moins l’un des comptes de test n’était pas valide, car le compte n’existe pas ou parce que l’utilisateur n’a pas été activé pour 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. Vous pouvez vérifier que le compte existe et que le compte a été activé pour nm-OCS-14-3e en exécutant une commande semblable à celle-ci :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

Si Test-CsGroupIM échoue, vous pouvez réexécuter le test, en incluant cette fois le paramètre 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

Lorsque le paramètre Verbose est inclus, Test-CsGroupIM renvoie un compte pas à pas de chaque action effectuée lorsqu’il a vérifié que les utilisateurs spécifiés peuvent participer à une session de messagerie instantanée de groupe.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. Par exemple, si votre test échoue et que vous êtes informé qu’un ou plusieurs comptes d’utilisateur ne sont pas valides, vous pouvez réexécuter le test à l’aide du paramètre Verbose et déterminer le compte d’utilisateur qui n’est pas valide :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:

Envoi d’une demande d’inscription :Sending Registration request:

 Nom de domaine complet cible = atl-cs-001.litwareinc.comTarget Fqdn      = atl-cs-001.litwareinc.com

 Adresse SIP de l’utilisateur = sip :kenmyer@litwareinc.comUser SIP Address = sip:kenmyer@litwareinc.com

 Port d’inscription = 5061Register Port    = 5061

Le type d’authentification « IWA » est sélectionné.Auth type 'IWA' is selected.

Une exception’l’ouverture de session a été refusée.An exception 'The log on was denied. Vérifiez que les informations d’identification correctes sont utilisées et que le compte est actif.Check that the correct credentials are being used and the account is active'

Comme vous pouvez le voir, dans cet exemple, l’utilisateur disposant de l’adresse SIP sip :kenmyer@litwareinc.com n’a pas pu se connecter.As you can see, in this example the user who has the SIP address sip:kenmyer@litwareinc.com was not able to log on.

Raisons pour lesquelles le test a pu échouerReasons why the test might have failed

Voici quelques raisons courantes pour lesquelles Test-CsGroupIM peut échouer :Here are some common reasons why Test-CsGroupIM might fail:

  • Vous avez spécifié un compte d’utilisateur incorrect.You specified an incorrect user account. Vous pouvez vérifier qu’un compte d’utilisateur existe en exécutant une commande semblable à celle-ci :You can verify that a user account exists by running a command similar to this:

    Get-CsUser "sip:kenmyer@litwareinc.com"
    
  • Le compte d’utilisateur est valide, mais le compte n’est actuellement pas activé pour Lync Server.The user account is valid, but the account is currently not enabled for Lync Server. Pour vérifier qu’un compte d’utilisateur a été activé pour Lync Server, exécutez une commande semblable à la suivante :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 activéGet-CsUser "sip:kenmyer@litwareinc.com" | Select-Object Enabled

    Si la propriété Enabled est définie sur false, cela signifie que l’utilisateur n’est actuellement pas activé pour Lync Server.If the Enabled property is set to False, that means that the user is currently not enabled for Lync Server.

  • Le service de messagerie instantanée n’est peut-être pas disponible.The instant messaging service might not be available. Avec Lync Server, vous pouvez configurer le système de sorte que la messagerie instantanée ne soit pas disponible si la base de données d’archivage est inaccessible.With Lync Server, you can configure the system so that instant messaging is not available if the archiving database cannot be accessed. Vous pouvez vérifier qu’en exécutant une commande semblable à la suivante :You can verify that by running a command similar to the following:

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

    Si BlockOnArchiveFailure est défini sur true, vous devez déterminer si la base de données d’archivage est disponible ou non.If BlockOnArchiveFailure is set to True, then you should determine whether or not the archiving database is available. Vous pouvez renvoyer les emplacements de vos bases de données d’archivage à l’aide de la commande suivante :You can return the locations of your archiving databases by using the following command:

    Get-CsService -ArchivingDatabase
    
  • Le serveur d’archivage n’est peut-être pas disponible.The Archiving Server might not be available. Vous pouvez récupérer le nom de domaine complet de vos serveurs d’archivage à l’aide de la commande suivante :You can retrieve the FQDN of your Archiving Servers by using this command:

    Get-CsService -ArchivingServer
    

    Vous pouvez ensuite exécuter la commande ping sur le serveur approprié pour vérifier qu’il est disponible.You can then ping the appropriate server to verify that it is available. Par exemple :For example:

    ping atl-archiving-001.litwareinc.com