Инструменты и ресурсы для устранения неполадок приложений EWS для Exchange
Найдите ресурсы, которые помогут устранить неполадки в управляемом API EWS или приложении EWS.
Не всегда все идет по плану. Иногда запросы EWS терпят сбой или дают неожиданные результаты. Это может быть неприятно, особенно если причина не очевидна. Надеюсь, с вами этого никогда не случится, но если это произойдет, в этой статье содержатся сведения об инструментах и ресурсах, которые можно использовать для устранения неполадок.
Примечание.
В этой статье представлены общие советы по устранению неполадок и источники информации по устранению неполадок. К сожалению, невозможно предоставить подробные действия по устранению неполадок. Подробнее о помощи в устранении конкретной ошибки см. в разделе Дальнейшие действия.
Изучение запросов и ответов SOAP
Если что-то работает неправильно, это помогает понять, что происходит. Первая линия запроса при исследовании проблемы с EWS или управляемым API EWS — это проверка запросов, которые приложение отправляет по сети, и ответов, которые сервер отправляет обратно.
Управляемый API EWS упрощает изучение запросов и ответов SOAP с помощью встроенных функций трассировки. Если вы используете EWS, у вас может быть или не быть доступа к аналогичным функциям трассировки, в зависимости от того, какую платформу или классы вы используете для отправки запросов. Однако вы всегда можете использовать средство трассировки сети, такой как сетевой монитор илиFiddler, для проверки сетевого трафика и просмотра полезных данных запроса и ответа.
Кроме того, вы можете инструментировать клиентские запросы для улучшения сведений, доступных в запросах и ответах.
После получения запросов и ответов, задайте себе следующий вопрос: правильно ли они выглядят? Ожидаются ли значения, которые отправляет ваше приложение? Есть ли смысл в ответах?
Проверка кодов ошибок
Иногда код ошибки может иметь большое значение для определения проблемы, даже если на первый взгляд это не имеет смысла. Указывает ли ошибка на то, что ваш клиент отрегулирован? Возможно, следует обратиться в автообнаружение для обновления сведений о конфигурации?
Дополнительные сведения об обработке определенных ошибок см. в перечисленных ниже статьях.
Обработка ошибок, связанных с уведомлениями, в EWS в Exchange
Обработка ошибок, связанных с синхронизацией, в EWS в Exchange
Проверка версий
В операциях EWS участвует ряд различных компонентов, и версии этих компонентов могут влиять на результаты.
Таблица 1. Компоненты с версиями, которые могут повлиять на процессы EWS
Компонент | Управляемый API EWS | EWS | Примечания |
---|---|---|---|
Запрашиваемая версия сервера |
Свойство ExchangeServiceBase.RequestedServerVersion |
Элемент RequestServerVersion |
Это значение определяет, какая версия схемы EWS используется для обработки запроса EWS. Убедитесь, что указанная здесь версия схемы подходит для отправляемого запроса. Некоторые свойства и операции недоступны в более ранних версиях схемы. |
Версия сервера |
Свойство ExchangeServiceBase.ServerInfo |
Элемент ServerVersionInfo |
Это значение возвращается сервером в ответах EWS и указывает версию сервера, обработавшего ответ. Убедитесь, что это значение соответствует вашим ожиданиям. По возможности убедитесь, что на сервере Exchange установлено самое последнее обновление для основной версии Exchange. |
Версия управляемого API EWS |
Свойство версии продукта файла Microsoft.Exchange.WebServices.dll. |
Неприменимо |
Если вы используете управляемый API EWS, убедитесь, что вы используете самую последнюю версию. |
Проверка доступа
EWS включен по умолчанию, но значения по умолчанию можно изменить. Используйте командлет Get-OrganizationConfig, чтобы убедиться, что EWS включен на сервере, и командлет Get-CASMailbox, чтобы убедиться, что EWS включен для почтового ящика пользователя. Также проверьте оба ответа командлета на наличие разрешенного или заблокированного списка EWS и убедитесь, что ваше приложение не заблокировано для использования EWS.
Необходимо также убедиться, что параметры проверки подлинности по умолчанию в виртуальном каталоге EWS не были изменены.
Попробуйте другой клиент EWS
Иногда полезно попробовать тот же запрос от другого клиента и сравнить результаты. Если другой клиент получает другие результаты, что изменится? Выявление различий между успешным и неудачным запросом может помочь объяснить, почему конкретный запрос не выполняется.
Конечно, вы можете написать другого клиента для проверки, но это не обязательно! EWSEditor — это пример клиента, который использует управляемый API EWS и EWS. Вы можете загрузить клиент (включая исходный код) и использовать его для выполнения тех же запросов, которые не работают в вашем приложении.
Изучение журналов IIS
Если у вас есть доступ к серверу Exchange, функция ведения журнала, предоставляемая службами IIS на серверах клиентского доступа, могут предоставлять дополнительные сведения о сбоях. Однако имейте в виду, что журналы IIS будут полезны только при получении ошибки HTTP.
IIS предоставляет два различных метода ведения журнала: ведение журнала IIS и отслеживание неудачных запросов. Для работы с журналами IIS можно использовать Log Parser Studio, которая включает ряд встроенных запросов EWS.
Дальнейшие действия
Теперь, когда вы узнали об инструментах и ресурсах, которые можно использовать для устранения неполадок, вам может потребоваться помощь в понимании информации, предоставляемой этими средствами. Ниже приведены некоторые варианты получения справки:
Форум разработчиков Exchange Server в Microsoft Q&A — задайте вопрос сообществу разработчиков Exchange Server в Microsoft Q&A.
StackOverflow — задайте вопрос сообществу StackOverflow. Обязательно пометьте свой пост "EWS".
Служба поддержки Майкрософт — обратитесь за помощью к специалисту службы поддержки Майкрософт.
См. также
См. следующие статьи:
Трассировка запросов и ответов для устранения неполадок в приложениях управляемого API EWS
Инструментирование запросов клиентов для EWS и REST в Exchange
Обновление сведений о конфигурации с помощью службы автообнаружения
Обработка ошибок, связанных с уведомлениями, в EWS в Exchange
Обработка ошибок, связанных с синхронизацией, в EWS в Exchange
Устранение неполадок с невыполненными запросами с помощью трассировки в IIS 7
Скачайте следующее: