Possibilité de tester la messagerie instantanée de groupe dans Lync Server 2013

  • Article

 

Rubrique Dernière modification : 2014-06-05

Planification de vérification

Jour

Outil de test

Windows PowerShell

Autorisations requises

En cas d’exécution locale à l’aide de Lync Server Management Shell, les utilisateurs doivent être membres du groupe de sécurité RTCUniversalServerAdmins.

Lors de l’exécution à l’aide d’une instance distante de Windows PowerShell, un rôle RBAC doit être attribué aux utilisateurs qui ont l’autorisation d’exécuter l’applet de commande Test-CsGroupIM. Pour afficher la liste de tous les rôles RBAC qui peuvent utiliser cette applet de commande, exécutez la commande suivante à partir de l’invite Windows PowerShell :

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

Description

L’applet de commande Test-CsGroupIM vérifie que les utilisateurs de votre organisation peuvent effectuer des sessions de messagerie instantanée de groupe. Lorsque vous exécutez Test-CsGroupIM, l’applet de commande tente de connecter une paire d’utilisateurs de test à Lync Server. En cas de réussite, Test-CsGroupIM crée une conférence à l’aide du premier utilisateur de test, puis invite le deuxième utilisateur à participer à la conférence. Après un échange de messages, les deux utilisateurs sont déconnectés du système. Notez que tout cela se produit sans aucune interaction de l’utilisateur et sans affecter les utilisateurs réels. Par exemple, supposons que le compte de test sip :kenmyer@litwareinc.com correspond à un utilisateur réel qui a un compte Lync Server réel. Dans ce cas, le test sera effectué sans interruption pour le vrai Ken Myer. Par exemple, même lorsque le compte de test Ken Myer se déconnecte du système, Ken Myer la personne reste connectée. De même, le vrai Ken Myer ne recevra pas d’invitation à participer à la conférence. Cette invitation sera envoyée au compte de test et acceptée par celle-ci.

Pour plus d’informations, consultez la documentation d’aide de l’applet de commande Test-CsGroupIM .

Exécution du test

L’applet de commande 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 de tests Lync Server) ou des comptes de deux utilisateurs activés pour 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é. Par exemple :

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 et le mot de passe du compte) pour chaque compte. Vous devez ensuite inclure ces objets d’informations d’identification et les adresses SIP des deux comptes lorsque vous appelez 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, consultez la documentation d’aide de l’applet de commande Test-CsGroupIM .

Détermination de la réussite ou de l’échec

Si les deux utilisateurs peuvent terminer une session de messagerie instantanée de groupe, vous recevrez une sortie similaire à celle-ci avec la propriété Result marquée comme Réussite :

TargetFqdn : atl-cs-001.litwareinc.com

Résultat : Réussite

Latence : 00:00:06.3812203

Erreur:

Diagnostic:

Si les deux utilisateurs ne peuvent pas terminer la session de messagerie instantanée, le résultat s’affiche sous la forme Échec et des informations supplémentaires sont enregistrées dans les propriétés Erreur et Diagnostic :

TargetFqdn : atl-cs-001.litwareinc.com

Résultat : Échec

Latence : 00:00:00

Erreur : 404, introuvable

Diagnostic : ErrorCode=4005,Source=atl-cs-001.litwareinc.com,

Reason=URI de destination n’est pas activé pour SIP ou n’est pas activé

Existe.

Microsoft.Rtc.Signaling.DiagnosticHeader

La sortie précédente indique que le test a échoué parce qu’au moins un des comptes de test n’était pas valide, soit parce que le compte n’existe pas, soit parce que l’utilisateur n’a pas été activé pour Lync Server. Vous pouvez vérifier que le compte existe et si le compte a été activé ou non pour nm-ocs-14-3rd en exécutant une commande similaire à celle-ci :

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

Si Test-CsGroupIM échoue, vous souhaiterez peut-être réexécuter le test, cette fois avec le paramètre Détaillé :

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

Lorsque le paramètre Détaillé est inclus, Test-CsGroupIM retourne un compte pas à pas de chaque action qu’il a tentée lorsqu’il a vérifié la capacité des utilisateurs spécifiés à participer à des sessions de messagerie instantanée de groupe. Par exemple, si votre test échoue et qu’un ou plusieurs comptes d’utilisateur ne sont pas valides, vous pouvez réexécuter le test à l’aide du paramètre Détaillé et déterminer quel compte d’utilisateur n’est pas valide :

Envoi d’une demande d’inscription :

 Fqdn cible = atl-cs-001.litwareinc.com

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

 Inscrire le port = 5061

Le type d’authentification « IWA » est sélectionné.

Exception « L’ouverture de session a été refusée. Vérifiez que les informations d’identification correctes sont utilisées et que le compte est actif ».

Comme vous pouvez le voir, dans cet exemple, l’utilisateur qui a le sip d’adresse SIP :kenmyer@litwareinc.com n’a pas pu se connecter.

Raisons pour lesquelles le test a peut-être échoué

Voici quelques raisons courantes pour lesquelles Test-CsGroupIM risque d’échouer :

  • Vous avez spécifié un compte d’utilisateur incorrect. Vous pouvez vérifier qu’un compte d’utilisateur existe en exécutant une commande similaire à celle-ci :

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

  • Le compte d’utilisateur est valide, mais le compte n’est actuellement pas activé pour Lync Server. Pour vérifier qu’un compte d’utilisateur a été activé pour Lync Server, exécutez une commande similaire à ce qui suit :

    Get-CsUser « sip:kenmyer@litwareinc.com » | Select-Object activé

    Si la propriété Activée est définie sur False, cela signifie que l’utilisateur n’est actuellement pas activé pour Lync Server.

  • Le service de messagerie instantanée peut ne pas être disponible. Avec Lync Server, vous pouvez configurer le système afin que la messagerie instantanée ne soit pas disponible si la base de données d’archivage n’est pas accessible. Vous pouvez vérifier cela en exécutant une commande similaire à ce qui suit :

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

    Si BlockOnArchiveFailure a la valeur True, vous devez déterminer si la base de données d’archivage est disponible ou non. Vous pouvez retourner les emplacements de vos bases de données d’archivage à l’aide de la commande suivante :

    Get-CsService -ArchivingDatabase

  • Le serveur d’archivage n’est peut-être pas disponible. Vous pouvez récupérer le nom de domaine complet de vos serveurs d’archivage à l’aide de cette commande :

    Get-CsService -ArchivingServer

    Vous pouvez ensuite effectuer un test ping sur le serveur approprié pour vérifier qu’il est disponible. Par exemple :

    ping atl-archiving-001.litwareinc.com