Partager via

Outils et ressources pour la résolution des problèmes des applications EWS pour Exchange

  • Article

Trouvez des ressources pour vous aider à résoudre les problèmes de votre API gérée EWS ou de votre application EWS.

Les choses ne se passent pas toujours comme prévu. Parfois, les demandes EWS échouent ou fournissent des résultats inattendus. Cela peut être frustrant, surtout si la raison n’est pas évidente. Nous espérons que cela ne vous arrive jamais, mais si c’est le cas, cet article fournit des informations sur les outils et les ressources que vous pouvez utiliser pour vous aider à résoudre votre problème.

Remarque

Cet article fournit des conseils généraux de résolution des problèmes et des sources d’informations de résolution de problèmes. Malheureusement, il n’est pas possible de fournir des étapes détaillées de résolution des problèmes. Pour obtenir de l’aide pour résoudre votre erreur spécifique, consultez Étapes suivantes.

Examiner les requêtes et réponses SOAP

Lorsque les choses ne fonctionnent pas correctement, il est vraiment utile de voir ce qui se passe. La première ligne de requête lors de l’examen d’un problème avec EWS ou l’API gérée EWS consiste à examiner les demandes que votre application envoie sur le réseau et les réponses que le serveur renvoie.

L’API gérée EWS facilite l’examen des requêtes et des réponses SOAP grâce à sa fonctionnalité intégrée de suivi. Si vous utilisez EWS, vous pouvez avoir ou non accès à des fonctionnalités de suivi similaires, selon la plateforme ou les classes que vous utilisez pour envoyer vos demandes. Toutefois, vous pouvez toujours utiliser un outil de suivi réseau tel que Moniteur réseau ou Fiddler pour examiner le trafic réseau et afficher les charges utiles de demande et de réponse.

En outre, vous pouvez instrumenter les demandes de votre client pour améliorer les informations disponibles dans les demandes et les réponses.

Une fois que vous avez les demandes et les réponses, demandez-vous ce qui suit : sont-elles correctes ? Les valeurs que votre application envoie sont-elles attendues ? Les réponses sont-ils logiques ?

Examiner les codes d’erreur

Parfois, le code d’erreur peut aller beaucoup plus loin dans la localisation du problème, même si, d’un coup d’œil, il semble peu logique. L’erreur indique-t-elle que votre client est en cours de limitation ? Un appel à la découverte automatique pour actualiser les informations de configuration est-il peut-être à prendre en compte ?

Pour plus d’informations sur le traitement des erreurs spécifiques, consultez les articles suivants :

Vérifier les versions

Plusieurs composants sont impliqués dans les opérations EWS et les versions de ces composants peuvent influencer les résultats.

Tableau 1. Composants avec version pouvant affecter les processus EWS

Composant API managée par EWS EWS Notes
Version du serveur demandée
 Propriété ExchangeServiceBase.RequestedServerVersion
 Élément RequestServerVersion
 Cette valeur contrôle la version du schéma EWS utilisée pour traiter la demande EWS. Assurez-vous que la version de schéma spécifiée ici est logique pour la demande que vous envoyez. Certaines propriétés et opérations ne sont pas disponibles dans les versions antérieures du schéma.
Version du serveur
 Propriété ExchangeServiceBase.ServerInfo
 Élément ServerVersionInfo
 Cette valeur est renvoyée par le serveur dans les réponses EWS et indique la version du serveur qui a traitée la réponse. Vérifiez que cette valeur est celle que vous attendez. Si possible, assurez-vous que le serveur Exchange exécute la mise à jour la plus récente pour votre version principale de Exchange.
Version d’API managée par EWS
 Propriété de version de produit du fichier Microsoft.Exchange.WebServices.dll de données.
Non applicable
 Si vous utilisez l’API gérée EWS, assurez-vous que vous utilisez la version la plus récente.

Vérifier l’accès

EWS est activé par défaut, mais les valeurs par défaut peuvent être modifiées. Utilisez la cmdlet Get-OrganizationConfig pour vous assurer qu’EWS est activé sur le serveur et la cmdlet Get-CASMailbox pour vous assurer que EWS est activé pour la boîte aux lettres de l’utilisateur. Vérifiez également les deux réponses de cmdlet pour une liste autoriser ou bloquer d’EWS, et assurez-vous que votre application n’est pas bloquée pour utiliser EWS.

Vous devez également vérifier que les paramètres d’authentification par défaut sur le répertoire virtuel EWS n’ont pas été modifiés.

Essayer un autre client EWS

Parfois, il est utile d’essayer la même demande à partir d’un autre client et de comparer les résultats. Si un autre client obtient des résultats différents, qu’est-ce qui est différent ? Déterminer ce qui est différent entre une demande réussie et une demande ayant échoué peut aider à expliquer pourquoi une demande particulière échoue.

Même si vous pouvez certainement écrire un autre client pour le test, vous n’en avez pas besoin ! EWSEditor est un exemple de client qui utilise l’API gérée EWS et EWS. Vous pouvez télécharger le client (y compris le code source) et l’utiliser pour essayer les mêmes demandes qui échouent dans votre application.

Examiner les journaux IIS

Si vous avez accès au serveur Exchange, la fonctionnalité de journalisation fournie par Internet Information Services (IIS) sur les serveurs d’accès au client peut fournir plus d’informations sur les défaillances. Toutefois, gardez à l’esprit que les journaux IIS ne seront utiles que si vous recevez une erreur HTTP.

IIS fournit deux méthodes de journalisation différentes : la journalisation IIS et le suivi des demandes qui ont échoué. Pour utiliser les journaux IIS, vous pouvez utiliser Log Parser Studio qui inclut un certain nombre de requêtes EWS intégrées.

Étapes suivantes

Maintenant que vous avez découvert les outils et les ressources que vous pouvez utiliser pour résoudre les problèmes, vous aurez peut-être besoin d’aide pour comprendre les informations fournies par ces outils. Voici quelques options pour obtenir de l’aide :

Voir aussi

Consultez les articles suivants :

Téléchargez ce qui suit :