Configurer l’intégration de la messagerie instantanée à Outlook sur le web dans Exchange

  • Article

Pour configurer l’intégration de la messagerie instantanée entre Skype Entreprise Server et Outlook sur le web (anciennement Outlook Web App) dans Exchange 2016 ou Exchange 2019, vous devez utiliser Exchange Management Shell. Cette procédure est différente des versions antérieures d'Exchange, où vous deviez modifier le fichier web.config. Si vous modifiez le fichier web.config au lieu de suivre la procédure indiquée dans cette rubrique, les paramètres sont ignorés et les utilisateurs Outlook sur le web reçoivent le message d'erreur suivant :

There's a problem with instant messaging. Please try again later.

En outre, les erreurs d'intégrité suivantes sont générées dans le serveur Exchange :

  • HealthSet : OWA.Protocol.Dep

  • Objet : OWA.Protocol.Dep health set unhealthy (OwaIMInitializationFailedMonitor/OWA.Protocol.Dep) - Owa InstantMessaging provider failed to intialize

  • Message : Owa InstantMessaging provider failed to initialize due to incorrect IM configuration on the server. Signin attempts to OWA IM will fail. Error Message: {Instant Messaging Certificate Thumbprint is null or empty on web.config).

Utilisez les procédures de cette rubrique pour corriger ces erreurs et configurer l’intégration de la messagerie instantanée entre Skype Entreprise Server et Exchange 2016 ou Exchange 2019. L’intégration de la messagerie instantanée entre Lync Server 2013 et Exchange 2016 ou version ultérieure n’est pas prise en charge. Pour plus d’informations sur la configuration de Skype Entreprise Server avec Outlook sur le web (anciennement Outlook Web App), voir Configurer l’intégration entre les Skype Entreprise Server locales et Outlook Web App

Ce qu'il faut savoir avant de commencer

  • Durée d’exécution estimée : 5 minutes

  • L'intégration Exchange et Skype Entreprise requiert des certificats de serveur approuvés par tous les serveurs impliqués. Les procédures indiquées dans cette rubrique supposent que vous avez déjà les certificats requis. Pour plus d'informations, voir Planification de l'intégration de Skype Entreprise et d'Exchange. L’empreinte numérique du certificat de messagerie instantanée requise fait référence au certificat Exchange Server affecté au service IIS.

  • Vous pouvez uniquement utiliser PowerShell pour effectuer cette procédure. Pour en savoir plus sur l'ouverture de l'environnement de ligne de commande Exchange Management Shell dans votre organisation Exchange locale, consultez la rubrique Open the Exchange Management Shell.

  • Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette procédure. Pour voir les autorisations qui vous sont nécessaires, consultez l'entrée « Paramètres de répertoire virtuel d'accès au client » dans la rubrique Autorisations des clients et des périphériques mobiles.

  • En fonction de votre topologie Skype Entreprise Server, vous pouvez avoir plusieurs pools front-end. Vous devez choisir le point de terminaison régional (pool le plus proche du site AD exchange) : IMServerName=<Skype Server\pool Name>.

Conseil

Vous rencontrez des difficultés ? Demandez de l'aide en participant aux forums Exchange. Visitez le forum à l'adresse : Exchange Server, Exchange Online ou Exchange Online Protection.

Utiliser Environnement de ligne de commande Exchange Management Shell pour configurer l'intégration de la messagerie instantanée avec Outlook sur le web

Étape 1 : Spécifiez le serveur de messagerie instantanée et l’empreinte numérique du certificat de messagerie instantanée

Utilisez la syntaxe suivante dans Environnement de ligne de commande Exchange Management Shell pour indiquer le serveur de messagerie instantanée et l'empreinte de certificat de messagerie instantanée :

New-SettingOverride -Name "<UniqueOverrideName>" -Component OwaServer -Section IMSettings -Parameters @("IMServerName=<Skype server/pool  name>","IMCertificateThumbprint=<Certificate Thumbprint>") -Reason "<DescriptiveReason>" [-Server <ServerName>]

Remarques :

  • Pour configurer les mêmes paramètres sur tous les serveurs Exchange 2016 et Exchange 2019 dans la forêt Active Directory, n’utilisez pas le paramètre Server .

  • Pour configurer les paramètres sur un serveur Exchange 2016 ou Exchange 2019 spécifique, utilisez le paramètre Server et le nom du serveur (n’utilisez pas le nom de domaine complet ou le nom de domaine complet). Cette méthode est utile lorsque vous devez spécifier des paramètres différents sur des serveurs Exchange différents.

Cet exemple spécifie l’empreinte numérique du serveur de messagerie instantanée et du certificat de messagerie instantanée sur tous les serveurs Exchange 2016 et Exchange 2019 de l’organisation.

  • Définition du nom de remplacement : « Remplacement de messagerie instantanée » (doit être unique)

  • nom du serveur Skype Entreprise : skype01.contoso.com

  • Empreinte numérique du certificat : CDF34A740E9D225A1A06193A9D44B2CE22775308

  • Raison du remplacement : Configurer la messagerie instantanée

New-SettingOverride -Name "IM Override"  -Component OwaServer -Section IMSettings -Parameters @("IMServerName=skype01.contoso.com","IMCertificateThumbprint=CDF34A740E9D225A1A06193A9D44B2CE22775308") -Reason "Configure IM"

Cet exemple indique le serveur de messagerie instantanée et l'empreinte numérique du certificat de messagerie instantanée, mais uniquement sur le serveur nommé Mailbox01.

New-SettingOverride -Name "Mailbox01 IM Override"  -Component OwaServer -Section IMSettings -Parameters @("IMServerName=skype01.contoso.com","IMCertificateThumbprint=CDF34A740E9D225A1A06193A9D44B2CE22775308") -Reason "Configure IM" -Server Mailbox01

Étape 2 : Actualisez les paramètres de messagerie instantanée sur le serveur Exchange

Utilisez la syntaxe suivante dans Environnement de ligne de commande Exchange Management Shell pour actualiser les paramètres de messagerie instantanée sur le serveur. Vous devez le faire sur chaque serveur Exchange 2016 ou Exchange 2019 utilisé pour Outlook sur le web.

Get-ExchangeDiagnosticInfo -Server <ServerName> -Process Microsoft.Exchange.Directory.TopologyService -Component VariantConfiguration -Argument Refresh

Cet exemple montre comment actualiser les paramètres de messagerie instantanée sur le serveur nommé Mailbox01.

Get-ExchangeDiagnosticInfo -Server Mailbox01 -Process Microsoft.Exchange.Directory.TopologyService -Component VariantConfiguration -Argument Refresh

Étape 3 : Redémarrer le pool Outlook sur le web sur le serveur Exchange

Exécutez la commande suivante dans Environnement de ligne de commande Exchange Management Shell ou dans Windows PowerShell sur le serveur. Vous devez le faire sur chaque serveur Exchange 2016 ou Exchange 2019 utilisé pour Outlook sur le web.

Restart-WebAppPool MSExchangeOWAAppPool

Utiliser Exchange Management Shell pour mettre à jour l’intégration de messagerie instantanée existante avec Outlook sur le web lorsque le certificat IIS Exchange est renouvelé ou modifié

Étape 1 : Mettre à jour l’empreinte numérique du certificat de messagerie instantanée sur le remplacement existant

Utilisez la syntaxe suivante dans Exchange Management Shell pour spécifier une nouvelle empreinte numérique de certificat de messagerie instantanée :

Set-SettingOverride -Name "<UniqueOverrideName>" -Parameters @("IMCertificateThumbprint=<Certificate Thumbprint>") -Reason "<DescriptiveReason>" [-Server <ServerName>]

Remarques :

  • Pour mettre à jour l’empreinte numérique sur tous les serveurs Exchange 2016 et Exchange 2019 dans la forêt Active Directory, n’utilisez pas le paramètre Server .

  • Pour mettre à jour l’empreinte numérique sur un serveur Exchange 2016 ou Exchange 2019 spécifique, utilisez le paramètre Server et le nom du serveur (n’utilisez pas le nom de domaine complet ou le nom de domaine complet). Cette méthode est utile lorsque vous devez spécifier des paramètres différents sur des serveurs Exchange différents.

Cet exemple met à jour l’empreinte numérique du certificat de messagerie instantanée sur tous les serveurs Exchange 2016 et Exchange 2019 de l’organisation.

  • Définition du nom du remplacement : « Remplacement de messagerie instantanée » (doit utiliser celui déjà en place des étapes précédentes, car nous mettons à jour et ne créons pas de nouveau)

  • nom du serveur Skype Entreprise : skype01.contoso.com

  • Empreinte numérique du certificat : NKT34A740E9D225A1A06193A9D44B2CE22771080

  • Raison du remplacement : Configurer la messagerie instantanée

Set-SettingOverride -Name "<UniqueOverrideName>" -Component OwaServer -Section IMSettings -Parameters @("IMServerName=<Skype server/pool  name>","IMCertificateThumbprint=<Certificate Thumbprint>") -Reason "<DescriptiveReason>" [-Server <ServerName>]

Cet exemple indique le serveur de messagerie instantanée et l'empreinte numérique du certificat de messagerie instantanée, mais uniquement sur le serveur nommé Mailbox01.

Set-SettingOverride -Identity "Mailbox01 IM Override"  -Parameters @("IMServerName=skype01.contoso.com","IMCertificateThumbprint=NKT34A740E9D225A1A06193A9D44B2CE22771080") -Reason "Configure IM" -Server Mailbox01

Étape 2 : Actualisez les paramètres de messagerie instantanée sur le serveur Exchange

Utilisez la syntaxe suivante dans Environnement de ligne de commande Exchange Management Shell pour actualiser les paramètres de messagerie instantanée sur le serveur. Vous devez le faire sur chaque serveur Exchange 2016 ou Exchange 2019 utilisé pour Outlook sur le web.

Get-ExchangeDiagnosticInfo -Server <ServerName> -Process Microsoft.Exchange.Directory.TopologyService -Component VariantConfiguration -Argument Refresh

Cet exemple montre comment actualiser les paramètres de messagerie instantanée sur le serveur nommé Mailbox01.

Get-ExchangeDiagnosticInfo -Server Mailbox01 -Process Microsoft.Exchange.Directory.TopologyService -Component VariantConfiguration -Argument Refresh

Étape 3 : Redémarrer le pool Outlook sur le web sur le serveur Exchange

Exécutez la commande suivante dans Environnement de ligne de commande Exchange Management Shell ou dans Windows PowerShell sur le serveur. Vous devez le faire sur chaque serveur Exchange 2016 ou Exchange 2019 utilisé pour Outlook sur le web.

Restart-WebAppPool MSExchangeOWAAppPool

Comment savoir si cela a fonctionné ?

Vous savez que vous avez correctement configuré l'intégration de la messagerie instantanée avec Outlook sur le web lorsque le message d'erreur disparaît et que les clients peuvent se connecter à la messagerie instantanée.

Pour vérifier les valeurs des propriétés IMServerName et IMCertificateThumbprint sur un serveur Exchange, remplacez ServerName> par< le nom du serveur (et non le nom de domaine complet) et exécutez la commande suivante :

[xml]$diag=Get-ExchangeDiagnosticInfo -Server <ServerName> -Process MSExchangeMailboxAssistants -Component VariantConfiguration -Argument "Config,Component=OwaServer"; $diag.Diagnostics.Components.VariantConfiguration.Configuration.OwaServer.IMSettings

Remarque : Dans Exchange 2016 CU3 ou une version antérieure, vous devez utiliser des valeurs différentes pour certains paramètres :

  • Processus : Microsoft.Exchange.Directory.TopologyService (au lieu de MSExchangeMailboxAssistants).

  • Argument : Config (au lieu de "Config,Component=OwaServer").