Herramientas y recursos para solucionar problemas de las aplicaciones de EWS para ExchangeTools and resources for troubleshooting EWS applications for Exchange

Buscar recursos que le ayuden a solucionar problemas de la API administrada de EWS o de la aplicación de EWS.Find resources to help you troubleshoot your EWS Managed API or EWS application.

Las cosas no siempre se redirigen según lo previsto.Things don't always go as planned. A veces, las solicitudes de EWS producen errores o proporcionan resultados inesperados.Sometimes EWS requests fail, or provide unexpected results. Esto puede resultar frustrante, especialmente si la razón no es evidente.This can be frustrating, especially if the reason isn't obvious. Espero que esto no suceda nunca, pero si lo hace, este artículo proporciona información acerca de las herramientas y los recursos que puede usar para solucionar el problema.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.

Nota

En este artículo se proporcionan consejos y orígenes de solución de problemas generales para la información de solución de problemas.This article provides general troubleshooting advice and sources for troubleshooting information. Desafortunadamente, no es posible dar pasos detallados para la solución de problemas.Unfortunately it isn't possible to give detailed troubleshooting steps. Para obtener ayuda para solucionar el error específico, vea los siguientes pasos.For assistance troubleshooting your specific error, see Next steps.

Examinar las solicitudes y respuestas SOAPExamine the SOAP requests and responses

Cuando los elementos no funcionan correctamente, es muy útil para ver lo que ocurre.When things aren't working correctly, it really helps to be able to see what's going on. La primera línea de consulta al investigar un problema con EWS o con la API administrada de EWS es examinar las solicitudes que la aplicación envía a través de la red y las respuestas que el servidor envía de vuelta.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.

La API administrada de EWS facilita el examen de solicitudes y respuestas SOAP con su funcionalidad de seguimiento integrada.The EWS Managed API makes examining SOAP requests and responses easy with its built in tracing functionality. Si usa EWS, puede o no tener acceso a una funcionalidad de seguimiento similar, en función de la plataforma o clases que use para enviar las solicitudes.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. Sin embargo, siempre puede usar una herramienta de seguimiento de red como el monitor de red o Fiddler para examinar el tráfico de red y ver las cargas de solicitud y respuesta.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.

Además, puede instrumentar las solicitudes de cliente para mejorar la información disponible en las solicitudes y respuestas.Additionally, you can instrument your client requests to enhance the information available in requests and responses.

Una vez que tenga las solicitudes y respuestas, pregúntese lo siguiente: ¿parece que son correctas?After you have the requests and responses, ask yourself the following: Do they look correct? ¿Se esperan los valores que envía la aplicación?Are the values that your application is sending expected? ¿Las respuestas tienen sentido?Do the responses make sense?

Examinar los códigos de errorExamine error codes

A veces, el código de error puede avanzar mucho para identificar el problema, incluso si a primera vista no parece tener sentido.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. ¿El error indica que el cliente se está limitando?Does the error indicate that your client is being throttled? ¿Quizá una llamada a la detección automática para actualizar la información de configuración está en orden?Perhaps a call to Autodiscover to refresh configuration information is in order?

Para obtener más información acerca del tratamiento de errores específicos, vea los siguientes artículos:For more information about handling specific errors, see the following articles:

Comprobar versionesVerify versions

Hay varios componentes diferentes involucrados en las operaciones de EWS y las versiones de dichos componentes pueden influir en los resultados.There are a number of different components involved in EWS operations, and the versions of those components can influence the results.

Tabla 1. Componentes con versiones que pueden afectar a los procesos de EWSTable 1. Versioned components that can affect EWS processes

ComponenteComponent API administrada EWSEWS Managed API EWSEWS NotasNotes
Versión del servidor solicitadaRequested server version
Propiedad ExchangeServiceBase. RequestedServerVersionExchangeServiceBase.RequestedServerVersion property
Elemento RequestServerVersionRequestServerVersion element
Este valor controla la versión del esquema EWS que se usa para procesar la solicitud de EWS.This value controls which version of the EWS schema is used to process the EWS request. Asegúrese de que la versión del esquema que se especifica aquí tiene sentido para la solicitud que va a enviar.Make sure that the schema version specified here makes sense for the request you are sending. Algunas propiedades y operaciones no están disponibles en versiones anteriores del esquema.Some properties and operations are not available in earlier versions of the schema.
La versión del servidorThe server version
Propiedad ExchangeServiceBase. inicializadoExchangeServiceBase.ServerInfo property
Elemento ServerVersionInfoServerVersionInfo element
Este valor lo devuelve el servidor en las respuestas de EWS e indica la versión del servidor que procesó la respuesta.This value is returned by the server in EWS responses, and indicates the version of the server that processed the response. Asegúrese de que este valor es el esperado.Make sure this value is what you expect. Si es posible, asegúrese de que el servidor de Exchange ejecuta la actualización más reciente de la versión principal de Exchange.If possible, make sure that the Exchange server is running the most recent update for your major version of Exchange.
La versión de la API administrada de EWSThe EWS Managed API version
La propiedad Product version del archivo Microsoft. Exchange. webservices. dll.The Product version property of the Microsoft.Exchange.WebServices.dll file.
No aplicableNot applicable
Si está usando la API administrada de EWS, asegúrese de que está usando la versión más reciente.If you're using the EWS Managed API, make sure that you are using the most recent version.

Comprobación del accesoVerify access

EWS está habilitado de forma predeterminada, pero se pueden cambiar los valores predeterminados.EWS is enabled by default, but defaults can be changed. Use el cmdlet Get-OrganizationConfig para asegurarse de que EWS esté habilitado en el servidor y el cmdlet Get-CASMailbox para asegurarse de que EWS esté habilitado para el buzón de correo del usuario.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. Compruebe también ambas respuestas de cmdlet para una lista de permitidos o bloqueados de EWS y asegúrese de que la aplicación no esté bloqueada para usar 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.

También debe comprobar que no se ha modificado la configuración de autenticación predeterminada en el directorio virtual de EWS.You should also verify that the default authentication settings on the EWS virtual directory have not been modified.

Probar otro cliente de EWSTry another EWS client

A veces, es útil probar la misma solicitud desde otro cliente y comparar los resultados.Sometimes it is helpful to try the same request from another client and compare results. Si otro cliente obtiene resultados diferentes, ¿qué es diferente?If another client gets different results, what is different? Averiguar qué es diferente entre una solicitud correcta y una solicitud con errores puede ayudar a explicar por qué se produce un error en una solicitud determinada.Figuring out what is different between a successful request and a failed request can help explain why a particular request is failing.

Aunque puede escribir otro cliente para probarlo, no tiene que hacerlo.While you can certainly write another client to test with, you don't have to! EWSEditor es un cliente de ejemplo que usa la API administrada de EWS y EWS.EWSEditor is a sample client that uses the EWS Managed API and EWS. Puede descargar el cliente (incluido el código fuente) y usarlo para probar las mismas solicitudes que producen errores en la aplicación.You can download the client (including the source code) and use it to try the same requests that are failing in your application.

Examinar los registros de IISExamine IIS logs

Si tiene acceso al servidor de Exchange, la funcionalidad de registro que proporcionan los servicios de Internet Information Server (IIS) en los servidores de acceso de cliente puede proporcionar más información sobre los errores.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. Sin embargo, tenga en cuenta que los registros de IIS solo serán útiles si recibe un error de HTTP.However, keep in mind that IIS logs will only be helpful if you are receiving an HTTP error.

IIS proporciona dos métodos de registro diferentes: el registro de IIS y el seguimiento de solicitudes con error.IIS provides two different logging methods: IIS logging and failed requests tracing. Para trabajar con registros de IIS, puede usar log parser Studio, que incluye una serie de consultas de EWS integradas.To work with IIS logs, you can use Log Parser Studio, which includes a number of built-in EWS queries.

Siguientes pasosNext steps

Ahora que ya conoce las herramientas y los recursos que puede usar para solucionar problemas, es posible que necesite ayuda para comprender la información proporcionada por dichas herramientas.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. A continuación se muestran algunas opciones para obtener ayuda:The following are some options for getting help:

Vea tambiénSee also

Consulte los siguientes artículos:See the following articles:

Descargue lo siguiente:Download the following: