En savoir plus sur l’outil de dépannage de messagerie unifiée Exchange

S’applique à : Exchange Server 2013, Exchange Server 2016

L'outil de dépannage de la messagerie unifiée Microsoft Exchange 2010 est une cmdlet de l'environnement de ligne de commande Exchange Management Shell appelée Test-ExchangeUMCallFlow. Vous pouvez utiliser cet outil pour mener une série de tests de diagnostic à l'encontre de la messagerie unifiée de votre organisation. Si l'un des tests échoue, l'outil indique la raison de l'échec et les solutions possibles pour résoudre le problème. Vous pouvez utiliser l'outil de dépannage de la messagerie unifiée uniquement sur les serveurs Exchange 2010 ou version ultérieure.

L'outil de dépannage de la messagerie unifiée peut être utilisé pour tester si la messagerie vocale fonctionne correctement dans les déploiements locaux et intersite. Vous pouvez utiliser cet outil dans les déploiements de messagerie unifiée qui incluent Microsoft Office Communications Server 2007 R2 ou Microsoft Lync Server 2010 ou version ultérieure, ou dans les déploiements de messagerie unifiée qui incluent des passerelles VoIP, des autocommutateurs privés (PBX) IP ou des contrôleurs de frontière de session (SBC).

Remarque

L'outil de dépannage de la messagerie unifiée est utilisé à des fins de test et de dépannage. La cmdlet Test-UMConnectivity, en revanche, doit être utilisée à des fins de surveillance. La cmdlet Test-UMConnectivity est utilisée avec les packs de gestion SCOM (System Center Operations Manager) qui permettent de contrôler les serveurs de messagerie unifiée Exchange 2010, ou les serveurs de boîtes aux lettres et d'accès au client Exchange 2013, et les composants téléphoniques. La cmdlet Test-UMConnectivity effectue des tests SIP locaux et des tests de connexion locaux aux boîtes aux lettres, et peut s'exécuter comme tâche SCOM.

Vue d’ensemble

L’outil de dépannage de la messagerie unifiée permet d’effectuer plus facilement des tests et des dépannages dans les déploiements de messagerie unifiée. Lorsque l’outil de dépannage de la messagerie unifiée est lancé, il génère automatiquement des fichiers de suivi qui sont stockés dans le dossier C:\Users\%UserProfile%\AppData\Roaming\Microsoft Exchange 2010 UM Troubleshooting. Les fichiers de suivi suivants sont générés par l’outil :

  • UMTool_Collaboration : inclut les traces de pile RTC.
  • UMTool_DiagnosticLog : Listes tous les tests exécutés et leurs résultats.
  • UMTool_S4 : inclut les traces de pile de signalisation S4.
  • UMTool_SIPMessageLogs : inclut les traces SIP complètes pour l’appel de test effectué.

L'outil de dépannage de la messagerie unifiée se connecte directement à un contrôleur de frontière de session (SBC) local, s'il en existe un, ou à un contrôleur SBC d'un centre de données, et émule un appel entrant comme si l'appel provenait d'un PBX via une passerelle VoIP ou un PBX IP. L'outil de dépannage de la messagerie unifiée peut servir à diagnostiquer :

  • les paramètres incorrects dans des déploiements de la messagerie unifiée locaux ou intersites au sein desquels Office Communications Server 2007 R2 ou Microsoft Lync Server est déployé ;
  • les paramètres incorrects dans un équipement téléphonique local ou intersite qui inclut des passerelles VoIP et PBX ou PBX IP ;
  • les problèmes liés au système DNS (Domain Name System) ;
  • les problèmes de certificat lorsque vous utilisez des plans de numérotation de messagerie unifiée en mode SIP sécurisé ou Sécurisé ;
  • les problèmes de signalisation et de support pour DTMF (numérotation en fréquences vocales) et les données audio.

Si l'outil de dépannage de la messagerie unifiée détecte une défaillance dans votre configuration, il indique la raison de l'erreur et les solutions possibles pour résoudre les problèmes détectés. Les erreurs pouvant être signalées lorsque l'outil de dépannage de la messagerie unifiée est utilisé dans un déploiement local sont notamment les suivantes :

  • Le nombre maximal d'appels est atteint.
  • La messagerie unifiée n'est pas activée pour l'utilisateur.
  • Les informations concernant la passerelle IP, le plan de numérotation ou le groupement de postes de messagerie unifiée sont introuvables.
  • Le type de sécurité ne correspond pas au plan de numérotation de messagerie unifiée.
  • Aucun processus de travail n'est disponible pour traiter l'appel.
  • Le service de messagerie unifiée ou les services de routeur d'appels de messagerie unifiée sont arrêtés.
  • La forêt Active Directory est introuvable.
  • Aucun espace disque n'est disponible.
  • Des en-têtes SIP non valides ont été utilisés dans la requête.
  • Un appel a été émis vers un serveur Office Communications Server 2007 R2 ou un serveur Lync Server.
  • La passerelle IP MU est désactivée.
  • L'URI de l'utilisateur qui est appelé n'est pas valide.

Lorsque l'outil de dépannage de la messagerie unifiée est utilisé dans un déploiement intersite, les erreurs pouvant être signalées sont notamment les suivantes :

  • La messagerie unifiée n'est pas activée pour l'utilisateur.
  • La passerelle IP MU est désactivée.
  • L'URI de l'utilisateur n'est pas valide.
  • Le type de sécurité ne correspond pas au plan de numérotation de messagerie unifiée.
  • Des en-têtes SIP non valides ont été utilisés dans la requête.
  • Les informations concernant la passerelle IP, le plan de numérotation ou le groupement de postes de messagerie unifiée sont introuvables.

L'outil de dépannage de la messagerie unifiée envoie un fichier .wav d'exemple pendant 15 secondes. Une fois le fichier audio et le flux audio RTP envoyés et lus, l'outil indique des mesures générales de qualité audio afin de diagnostiquer les problèmes de qualité audio de la connexion réseau (gigue et perte moyenne de paquets). Ces rapports incluent la qualité du flux de données multimédia entrant et sortant d'un serveur de messagerie unifiée et contiennent les données suivantes :

  • Note moyenne d'opinion de réseau (NMOS)
  • Codec
  • Latence en millisecondes (ms)
  • Gigue en millisecondes (ms)
  • % de perte de paquets
  • La classification et l'évaluation NMOS utilisées pour déterminer la qualité audio sont :
    • NMOS inférieure à 2 = Médiocre
    • NMOS supérieure à 2, mais inférieure à 3 = Moyen
    • NMOS supérieure à 3, mais inférieure à 4 = Bon
    • NMOS supérieure à 4, mais inférieure à 5 = Excellent

L'outil de dépannage de la messagerie unifiée prend en charge le test des plans de numérotation MU qui utilisent des appels en mode Sécurisé, SIP sécurisé ou Non sécurisé. Si vous choisissez le mode Sécurisé ou SIP sécurisé, l'empreinte du certificat utilisé est vérifiée pour déterminer si le certificat a expiré et le type de certificat utilisé pour les communications TLS (Transport Layer Security). Le certificat permet d'assurer une identification correcte et de garantir l'identité de l'ordinateur distant. Lorsque le mode Sécurisé ou SIP sécurisé est sélectionné, l'outil de dépannage de la messagerie unifiée vérifie si les conditions suivantes sont vraies :

  • Le certificat local a été trouvé dans le magasin de l'ordinateur local.
  • Le certificat qui est en cours d'utilisation est approuvé.
  • Le nom de cible indiqué dans le certificat est valide.
  • Le certificat a expiré.
  • L'ordinateur distant approuve le certificat.
  • Le certificat a été révoqué.
  • Le certificat ne dispose pas de l'utilisation avancée de la clé requise.

L'outil de dépannage de la messagerie unifiée peut être exécuté en mode Gateway ou SIPClient, selon qu'Office Communications Server 2007 R2 ou Lync Server est déployé ou que les passerelles VoIP et les PBX ou les PBX IP sont utilisés avec les serveurs de messagerie unifiée. Lorsque le mode Gateway ou SIPClient est utilisé, l'outil de dépannage de la messagerie unifiée prend en charge les appels aux formats suivants. Le format utilisé dépend du type d'URI du plan de numérotation MU :

  • Poste téléphonique : 425-555-1010
  • Numéros de téléphone E.164 : +1 (425) 555-1010
  • Adresses SIP : tonysmith@contoso.com

Lorsque le mode SIPClient est utilisé, l’outil de résolution des problèmes de messagerie unifiée effectue un appel de mémo vocal. Il s’agit d’un appel qui ne sonne pas un téléphone ou un point de terminaison de communications unifiées (UC). Au lieu de cela, il envoie l’appel directement à la messagerie vocale. Lorsque l’outil de résolution des problèmes de messagerie unifiée est exécuté en mode SIPClient, il détermine :

  • l'utilisateur cible qui est appelé ;
  • si l'appel SIP a réussi ;
  • si l'appel SIP a été accepté par un serveur de messagerie unifiée Exchange 2010 ou un serveur de boîtes aux lettres Exchange 2013 ;
  • si la séquence DTMF appropriée a été reçue ;
  • si le fichier .wav de diagnostic a été envoyé et reçu par un serveur de messagerie unifiée Exchange 2010 ou un serveur de boîtes aux lettres Exchange 2013.
  • les outils de mesure utilisés à la réception du flux de qualité audio ou multimédia.

L'outil de dépannage de la messagerie unifiée émule des appels entrants et exécute des tests de diagnostic pour aider les administreurs locaux et les administrateurs de client à tester le flux des appels du répondeur automatique et à identifier les erreurs de configuration. Bien que l'outil de dépannage de la messagerie unifiée puisse tester le répondeur automatique, il ne peut pas être utilisé pour les types d'appels suivants :

  • Appels Outlook Voice Access, notamment les appels accédant à la messagerie vocale, à la messagerie électronique, au calendrier, au répertoire, aux contacts personnels ou aux options personnelles
  • Standards automatiques de messagerie unifiée
  • Émettre au téléphone
  • Règles de répondeur automatique
  • Télécopie
  • Approvisionnement d'une invite

Architecture de dépannage de la messagerie unifiée

L’outil de dépannage de la messagerie unifiée vous permet de dépanner, diagnostiquer et corriger les problèmes de configuration rencontrés dans des déploiements intersites, et vous pouvez également l’utiliser sur des déploiements de messagerie unifiée locaux. Dans les déploiements intersites, l'outil valide également les configurations SBC sur site. L’administrateur peut tester tous les composants utilisés par la messagerie unifiée, notamment les contrôleurs SBC.

Déploiements de PBX IP et de passerelle VoIP

Dans l’exemple suivant, le mode Gateway est utilisé pour tester le flux des appels dans un environnement qui n’inclut pas Office Communications Server 2007 R2 ou Lync Server. Cet exemple teste l'équipement téléphonique, qui inclut les passerelles VoIP, les PBX et PBX IP, et les composants de la messagerie unifiée. Cet exemple définit le mode de sécurité VoIP (Voice over IP) sur Non sécurisé, utilise l'adresse IP 10.1.1.1 comme saut suivant, et indique un numéro de poste dans les informations de diversion.

Test-ExchangeUMCallFlow -Mode Gateway -VoIPSecurity Unsecured -NextHop 10.1.1.1 -Diversion 12345

Déploiements d’Office Communications Server 2007 R2 et de Microsoft Lync Server

L'outil de dépannage de la messagerie unifiée peut être utilisé dans des déploiements locaux ou intersites qui incluent Office Communications Server 2007 R2 ou Microsoft Lync Server lorsque le mode SIPClient est défini. L'exemple suivant utilise le mode SIPClient et teste le flux des appels avec un plan de numérotation de messagerie unifiée sécurisé dans un environnement comprenant des serveurs Office Communications Server 2007 R2 ou Lync Server. Par défaut, lorsque vous exécutez l'outil de dépannage de la messagerie unifiée, il utilise les informations d'identification de l'utilisateur actuellement connecté à l'ordinateur. Lors de l'exécution de l'exemple suivant, vous serez invité à fournir les informations d'identification que vous souhaitez utiliser pour lancer l'outil de dépannage de la messagerie unifiée. Pour plus d'informations, voir Définir les informations d'identification à utiliser avec l'outil de dépannage de la messagerie unifiée Exchange.

Test-ExchangeUMCallFlow -Mode SIPClient -VoIPSecurity Secured -CallingParty tony@contoso.com -CalledParty david@contoso.com -Credential $get

Installation de l’outil de dépannage de la messagerie unifiée

L'outil de dépannage de la messagerie unifiée peut être installé sur un serveur local de messagerie unifiée ou sur un autre ordinateur 64 bits qui exécute :

  • les systèmes d'exploitation Windows 7 ou Windows 8 ;
  • les systèmes d'exploitation Windows Server 2008 ou Windows Server 2008 R2.
  • les systèmes d'exploitation Windows Server 2012 ou Windows Server 2012 R2.

Si vous utilisez l'outil de dépannage de la messagerie unifiée sur une version 64 bits de Windows 7, Windows 8 ou l'édition 64 bits de Windows Server 2008, les composants suivants doivent être installés pour pouvoir installer l'outil de dépannage de la messagerie unifiée :

L’outil de résolution des problèmes de messagerie unifiée (applet de commande Test-ExchangeUMCallFlow ) n’est pas inclus dans le DVD Exchange 2010 SP1, le téléchargement qui inclut uniquement Exchange 2010 ou le support d’installation d’Exchange 2013. Toutefois, vous pouvez télécharger l’outil de résolution des problèmes de messagerie unifiée.

Pour plus d'informations, voir Installer l'outil de dépannage de la messagerie unifiée Exchange.

Paramètres de l’applet de commande

Le tableau suivant inclut les paramètres que vous pouvez utiliser avec la cmdlet Test-ExchangeUMCallFlow, ainsi qu'une description de ces paramètres. Vous pouvez également utiliser la commande Get-help Test-ExchangeUMCallFlow -detailed Shell pour trouver des informations détaillées sur chaque paramètre pouvant être utilisé avec l’applet de commande Test-ExchangeUMCallFlow , ainsi que des exemples d’utilisation.

Paramètre Description
CalledParty Le paramètre CalledParty spécifie l’URI SIP de l’utilisateur Office Communications Server 2007 R2 ou Lync Server qui a été activé pour Téléphonie – Grandes entreprises. Il s’agit de l’utilisateur à qui l’applet de commande Test-ExchangeUMCallFlow effectuera l’appel vocal, par exemple : -CalledParty tonysmith@contoso.com. Utilisez ce paramètre si vous exécutez l'outil en mode SIPClient.
CallingParty Le paramètre CallingParty spécifie l’URI SIP de l’utilisateur Office Communications Server 2007 R2 ou Lync Server qui a été activé pour Téléphonie – Grandes entreprises. Il s’agit de l’utilisateur qui effectue l’appel entrant, par exemple : -CallingParty tonysmith@contoso.com. Utilisez ce paramètre si vous exécutez l'outil en mode SIPClient.
Diversion Le paramètre Diversion spécifie la chaîne à envoyer comme informations de diversion pour l'appel entrant. Elle peut prendre la forme d'un en-tête de diversion ou d'informations d'historique. Les informations de diversion incluses dans l'appel entrant peuvent être un numéro de poste ou comprendre d'autres informations de diversion.

Lorsque vous fournissez des informations de diversion telles que l'en-tête History-Info, vérifiez ce qui suit :
  • Au moins deux entrées différentes existent avec des parties utilisateur différentes.
  • La dernière entrée contient le numéro pilote du plan de numérotation de messagerie unifiée associée de l'utilisateur.
  • De la deuxième à la dernière entrée, le numéro d'extension de l'utilisateur à extension messagerie unifiée doit être inclus. Cette entrée doit également inclure le texte d'explication approprié. Ce texte doit être correctement évité selon les règles d'évitement du paramètre d'URL standard.
Mode Le paramètre Mode spécifie si la passerelle VoIP, LE PBX IP ou le mode Office Communications Server 2007 R2 ou Lync Server doit être utilisé. Vous pouvez spécifier le mode Gateway lorsque votre déploiement de messagerie unifiée comprend des passerelles VoIP ou des PBX IP, ou le mode SIPClient lorsque votre déploiement de messagerie unifiée comprend Office Communications Server 2007 R2 ou Lync Server.
NextHop Le paramètre NextHop spécifie l’adresse IP ou le nom de domaine complet (FQDN) du tronçon suivant et peut également inclure le port TCP du tronçon suivant auquel l’applet de commande Test-ExchangeUMCallFlow doit se connecter lors de l’émulation de la passerelle VoIP ou du PBX IP. Lorsque vous précisez le port TCP, vous devez indiquer le port 5060 en mode Non sécurisé ou le port 5061 en mode Sécurisé ou SIP sécurisé. Par exemple : gateway.contoso.com:5061.
CertificateThumbprint Le paramètre CertificateThumbprint spécifie l’empreinte numérique du certificat utilisé pour TLS. Ceci est obligatoire si le mode SIP sécurisé ou Sécurisé est configuré dans le plan de numérotation de messagerie unifiée. Cette empreinte de certificat correspond au certificat qui avait été exporté à partir de la passerelle VoIP, du PBX IP ou du SBC. De même, l'ordinateur doté de l'outil de dépannage de la messagerie unifiée et utilisé pour tester le flux des appels doit approuver le certificat d'autorité pour le saut suivant.
Credential Le paramètre Credential spécifie les informations d’identification qui seront utilisées pour exécuter l’applet de commande.
HuntGroup Le paramètre HuntGroup spécifie le groupe de chasse de messagerie unifiée associé à la passerelle VoIP émulée. Il s'agit généralement d'un numéro de poste. Utilisez ce paramètre si vous exécutez l'outil en mode Gateway.
VoIPSecurity Le paramètre VoIPSecurity spécifie le mode de sécurité lors de l’utilisation de l’applet de commande en mode passerelle. Vous pouvez utiliser un des modes de sécurité VoIP suivants :
  • Sécurisé (TLS/SRTP)
  • Non sécurisé (TCP/RTP) (valeur par défaut)
  • SIP sécurisé (TLS/RTP)