Инструменты и ресурсы для устранения неполадок приложений EWS для ExchangeTools and resources for troubleshooting EWS applications for Exchange

Найдите материалы, которые помогут вам устранить неполадки управляемого API EWS или приложения EWS.Find resources to help you troubleshoot your EWS Managed API or EWS application.

Все это не всегда запланировано.Things don't always go as planned. Иногда не удается выполнить запросы EWS, а также приводятся неожиданные результаты.Sometimes EWS requests fail, or provide unexpected results. Это может быть очень сложно, особенно если причина неочевидна.This can be frustrating, especially if the reason isn't obvious. Надеюсь, что это никогда не произойдет, но в этой статье представлены сведения о средствах и ресурсах, которые можно использовать для устранения неполадок.Hopefully this never happens to you, but if it does, this article provides information about tools and resources that you can use to help troubleshoot your problem.

Примечание

В этой статье приводятся общие рекомендации по устранению неполадок и источники сведений об устранении неполадок.This article provides general troubleshooting advice and sources for troubleshooting information. К сожалению, невозможно получить подробные инструкции по устранению неполадок.Unfortunately it isn't possible to give detailed troubleshooting steps. Помощь в устранении неполадок, связанных с конкретной ошибкой, приведено в разделе Дополнительные действия.For assistance troubleshooting your specific error, see Next steps.

Проверка запросов и ответов SOAPExamine the SOAP requests and responses

Если бы они не работали должным образом, она, в своюмся, может увидеть, что происходит.When things aren't working correctly, it really helps to be able to see what's going on. Первая строка запроса при исследовании проблемы с помощью EWS или управляемого API EWS — проверка запросов, которые приложение отправляет по сети, и ответы, отправляемые сервером обратно.The first line of inquiry when investigating a problem with EWS or the EWS Managed API is to examine the requests that your application is sending over the network and the responses that the server is sending back.

Управляемый API EWS упрощает анализ запросов и ответов SOAP с помощью встроенных функций трассировки.The EWS Managed API makes examining SOAP requests and responses easy with its built in tracing functionality. Если вы используете EWS, у вас может быть или нет доступа к аналогичной функции трассировки в зависимости от того, какие платформы или классы вы используете для отправки запросов.If you are using EWS, you might or might not have access to similar tracing functionality, depending on what platform or classes you use to send your requests. Однако вы всегда можете использовать средство трассировки сети, например, Network Monitor или Fiddler , для проверки сетевого трафика и просмотра полезных данных запроса и ответа.However, you can always use a network tracing tool like Network Monitor or Fiddler to examine the network traffic and view the request and response payloads.

Кроме того, вы можете инструментировать клиентские запросы для расширения информации, доступной в запросах и ответах.Additionally, you can instrument your client requests to enhance the information available in requests and responses.

После выполнения запросов и ответов ответьте на следующие вопросы: правильно ли они выглядят?After you have the requests and responses, ask yourself the following: Do they look correct? Предполагается, что ваше приложение посылается должным образом?Are the values that your application is sending expected? Имеете смысл принимать ответы?Do the responses make sense?

Проверка кодов ошибокExamine error codes

Иногда код ошибки может быть достаточно большим, даже если на первый взгляд он не имеет смысла.Sometimes the error code can go a long way toward pinpointing the problem, even if at first glance it doesn't seem to make sense. Указывает, что направляется регулированиеклиента?Does the error indicate that your client is being throttled? Возможно, вызов службы автообнаружения для обновления сведений о конфигурации выполняется по порядку?Perhaps a call to Autodiscover to refresh configuration information is in order?

Дополнительные сведения об обработке определенных ошибок можно найти в следующих статьях:For more information about handling specific errors, see the following articles:

Проверка версийVerify versions

В операциях EWS существует несколько различных компонентов, и их версии могут влиять на результаты.There are a number of different components involved in EWS operations, and the versions of those components can influence the results.

Таблица 1. Компоненты с версиями, которые могут повлиять на процессы EWSTable 1. Versioned components that can affect EWS processes

КомпонентComponent Управляемый API EWSEWS Managed API Службы EWSEWS ПримечанияNotes
Запрошенная версия сервераRequested server version
Свойство ексчанжесервицебасе. рекуестедсерверверсионExchangeServiceBase.RequestedServerVersion property
Элемент рекуестсерверверсионRequestServerVersion element
Это значение определяет, какая версия схемы EWS используется для обработки запроса EWS.This value controls which version of the EWS schema is used to process the EWS request. Убедитесь, что указанная здесь версия схемы имеет смысл для отправляемого запроса.Make sure that the schema version specified here makes sense for the request you are sending. Некоторые свойства и операции недоступны в более ранних версиях схемы.Some properties and operations are not available in earlier versions of the schema.
Версия сервераThe server version
Свойство ексчанжесервицебасе. серверинфоExchangeServiceBase.ServerInfo property
Элемент серверверсионинфоServerVersionInfo element
Это значение возвращается сервером в ответах EWS и указывает версию сервера, который обработал ответ.This value is returned by the server in EWS responses, and indicates the version of the server that processed the response. Убедитесь, что это значение ожидается.Make sure this value is what you expect. Если это возможно, убедитесь, что на сервере Exchange выполняется Последнее обновление основной версии Exchange.If possible, make sure that the Exchange server is running the most recent update for your major version of Exchange.
Версия управляемого API EWSThe EWS Managed API version
Свойство версии продукта для файла Microsoft. Exchange. WebServices. dll.The Product version property of the Microsoft.Exchange.WebServices.dll file.
НеприменимоNot applicable
Если вы используете управляемый API EWS, убедитесь, что вы используете самую последнюю версию.If you're using the EWS Managed API, make sure that you are using the most recent version.

Проверка доступаVerify access

По умолчанию EWS включена, но можно изменить значения по умолчанию.EWS is enabled by default, but defaults can be changed. С помощью командлета Get-OrganizationConfig убедитесь, что на сервере включена EWS, а также командлет Get-CASMailbox , чтобы убедиться, что для почтового ящика пользователя включена EWS.Use the Get-OrganizationConfig cmdlet to make sure that EWS is enabled on the server, and the Get-CASMailbox cmdlet to make sure that EWS is enabled for the user's mailbox. Кроме того, проверьте оба ответа командлета для списка разрешенных или заблокированных служб EWS и убедитесь, что приложение не заблокировано с помощью EWS.Also check both cmdlet responses for an EWS allow or block list, and make sure that your application isn't blocked from using EWS.

Кроме того, необходимо убедиться, что Параметры проверки подлинности по умолчанию в виртуальном каталоге EWS не были изменены.You should also verify that the default authentication settings on the EWS virtual directory have not been modified.

Попробуйте другой клиент EWSTry another EWS client

Иногда бывает полезно попробовать один и тот же запрос от другого клиента и сравнить результаты.Sometimes it is helpful to try the same request from another client and compare results. Если другой клиент получает разные результаты, что отличается?If another client gets different results, what is different? Выяснить, чем отличается успешный запрос, и неудачный запрос может помочь объяснить причину сбоя конкретного запроса.Figuring out what is different between a successful request and a failed request can help explain why a particular request is failing.

Несмотря на то, что вы наверняка можете написать другой клиент для тестирования, вам не нужно!While you can certainly write another client to test with, you don't have to! Евседитор — это пример клиента, который использует управляемый API EWS и EWS.EWSEditor is a sample client that uses the EWS Managed API and EWS. Вы можете скачать клиент (включая исходный код) и использовать его для попытаться использовать те же запросы, что и при неисправности в вашем приложении.You can download the client (including the source code) and use it to try the same requests that are failing in your application.

Проверка журналов IISExamine IIS logs

Если у вас есть доступ к серверу Exchange, функции ведения журнала, предоставляемые службами IIS на серверах клиентского доступа, могут предоставить дополнительные сведения об ошибках.If you have access to the Exchange server, the logging functionality provided by Internet Information Services (IIS) on the Client Access servers can provide more information about failures. Однако имейте в виду, что журналы IIS будут полезны только при получении сообщения об ошибке HTTP.However, keep in mind that IIS logs will only be helpful if you are receiving an HTTP error.

Службы IIS предоставляют два разных метода ведения журнала: мониторинг журналов IIS и неудачные запросы.IIS provides two different logging methods: IIS logging and failed requests tracing. Для работы с журналами IIS можно использовать средство Log Parser Studio, включающее ряд встроенных запросов EWS.To work with IIS logs, you can use Log Parser Studio, which includes a number of built-in EWS queries.

Дальнейшие действияNext steps

Теперь, когда вы узнали о средствах и ресурсах, которые можно использовать для устранения неполадок, может потребоваться помощь в понимании сведений, предоставляемых этими средствами.Now that you've learned about the tools and resources that you can use to troubleshoot, you might need help understanding the information provided by those tools. Ниже приведены некоторые способы получения справки.The following are some options for getting help:

См. такжеSee also

См. следующие статьи:See the following articles:

Скачайте следующие компоненты:Download the following: