Operações do EWS no ExchangeEWS operations in Exchange

Encontre informações sobre as operações do EWS disponíveis no Exchange.Find information about the EWS operations that are available in Exchange.

Os serviços Web do Exchange (EWS) oferecem muitas operações que permitem acessar informações do armazenamento do Exchange.Exchange Web Services (EWS) provides many operations that enable you to access information from the Exchange store. Os artigos desta seção fornecem informações sobre a estrutura geral das solicitações, respostas e mensagens de resposta de erro para operações do EWS, bem como exemplos XML para cada operação.The articles in this section provide information about the overall structure of the requests, responses, and error response messages for EWS operations, as well as XML examples for each operation. Eles fornecem uma visão geral das estruturas de mensagens que são enviadas entre o cliente e o servidor.They provide an overview of the message structures that are sent between the client and the server. Você pode usar essas informações para depurar estruturas de mensagens e localizar informações sobre o que você pode fazer em uma solicitação do EWS.You can use this information to debug message structures and to find information about what you can do in an EWS request. Para obter mais informações sobre o que a estrutura XML representa, consulte: elementos XML do EWS no Exchange.For more information about what the XML structure represents, see - EWS XML elements in Exchange.

Toda a funcionalidade do EWS está associada a uma versão do esquema.All EWS functionality is associated with a version of the schema. Novas versões de esquema do EWS são introduzidas em novas versões do Exchange Server ou Exchange Online.New EWS schema versions are introduced in new releases of Exchange Server or Exchange Online. O elemento RequestServerVersion contém um atributo version que mapeia a versão do servidor para a versão do esquema.The RequestServerVersion element contains a Version attribute that maps the server version to the schema version. Este artigo fornece informações sobre quando cada operação foi introduzida.This article provides information about when each operation was introduced. A funcionalidade específica dentro de uma operação pode exigir uma versão mais recente do serviço.Specific functionality within an operation might require a later version of the service. Os esquemas com controle de versão são implementados para que os clientes criados em uma versão mais antiga do EWS funcionem com uma versão mais recente do EWS.The versioned schemas are implemented so that clients that are designed against an older version of EWS will work with a newer version of EWS.

Essas operações podem ser direcionadas para o ponto de extremidade do EWS que Services sua caixa de correio.These operations can target the EWS endpoint that services your mailbox. Você pode navegar até o ponto de extremidade do EWS usando uma URL semelhante a http:// . com/EWS/Exchange. asmx, onde é o servidor de acesso para cliente do Exchange que Services sua caixa de correio.You can browse to the EWS endpoint by using a URL that is similar in structure to http://.com/ews/exchange.asmx, where is the Exchange Client Access server that services your mailbox. Você pode usar a descoberta automática para obter a URL para o servidor de acesso para cliente que é o serviço de sua caixa de correio.You can use Autodiscover to get the URL to the Client Access server that services your mailbox. Para obter mais informações sobre a descoberta automática, confira descoberta automática do Exchange.For more information about Autodiscover, see Autodiscover for Exchange.

operações de descoberta eletrônicaeDiscovery operations

As operações de descoberta eletrônica fornecem operações de pesquisa para isenções legais e identificam os dados de caixa de correio que não podem ser indexados e retornados nos resultados da pesquisa de descoberta.The eDiscovery operations provide search operations for legal holds and identify mailbox data that cannot be indexed and returned in discovery search results.

A tabela a seguir lista as operações de descoberta eletrônica.The following table lists the eDiscovery operations.

Nome da operaçãoOperation name Introduzido noIntroduced in
Operação GetDiscoverySearchConfigurationGetDiscoverySearchConfiguration operation
Exchange 2013Exchange 2013
Operação GetHoldOnMailboxesGetHoldOnMailboxes operation
Exchange 2013Exchange 2013
Operação GetNonIndexableItemDetailsGetNonIndexableItemDetails operation
Exchange 2013Exchange 2013
Operação GetNonIndexableItemStatisticsGetNonIndexableItemStatistics operation
Exchange 2013Exchange 2013
Operação GetSearchableMailboxesGetSearchableMailboxes operation
Exchange 2013Exchange 2013
Operação SearchMailboxesSearchMailboxes operation
Exchange 2013Exchange 2013
Operação SetHoldOnMailboxesSetHoldOnMailboxes operation
Exchange 2013Exchange 2013

Operações de dados de caixa de correio do ExchangeExchange mailbox data operations

As operações de dados de caixa de correio do Exchange permitem que os clientes manipulem e organizem itens, pastas e anexos, bem como a resolução de nome ambígua e a expansão da lista de distribuição.The Exchange mailbox data operations enable clients to handle and organize items, folders, and attachments, as well as ambiguous name resolution and distribution list expansion. As operações de dados de caixa de correio do Exchange incluem operações de item, pasta, anexo e utilitários.Exchange mailbox data operations include item, folder, attachment, and utilities operations.

A tabela a seguir lista as operações de dados de caixa de correio do Exchange.The following table lists the Exchange mailbox data operations.

Nome da operaçãoOperation name Introduzido noIntroduced in
Operação ArchiveItemArchiveItem operation
Exchange 2013Exchange 2013
Operação CreateItemCreateItem operation
Exchange 2007Exchange 2007
Operação CopyItemCopyItem operation
Exchange 2007Exchange 2007
Operação DeleteItemDeleteItem operation
Exchange 2007Exchange 2007
Operação FindItemFindItem operation
Exchange 2007Exchange 2007
Operação GetItemGetItem operation
Exchange 2007Exchange 2007
Operação MarkAllItemsAsReadMarkAllItemsAsRead operation
Exchange 2013Exchange 2013
Operação MoveItemMoveItem operation
Exchange 2007Exchange 2007
Operação SendItemSendItem operation
Exchange 2007Exchange 2007
Operação UpdateItemUpdateItem operation
Exchange 2007Exchange 2007

A tabela a seguir lista as operações de pasta de dados de caixa de correio do Exchange.The following table lists the Exchange mailbox data folder operations.

Nome da operaçãoOperation name Introduzido noIntroduced in
Operação CreateFolderCreateFolder operation
Exchange 2007Exchange 2007
Operação createfolderpathCreateFolderPath operation
Exchange 2013Exchange 2013
Operação CreateManagedFolderCreateManagedFolder operation
Exchange 2007.Exchange 2007. Essa funcionalidade foi enfatizada em versões do Exchange a partir do Exchange 2010.This functionality has been deemphasized in versions of Exchange starting with Exchange 2010. Para obter mais informações sobre como migrar para o uso de marcas e políticas de retenção para o gerenciamento de registros de mensagens, consulte Migrate from Managed Folders.For more information about how to migrate to using retention tags and policies for messaging records management, see Migrate from Managed Folders.
Operação CopyFolderCopyFolder operation
Exchange 2007Exchange 2007
Operação DeleteFolderDeleteFolder operation
Exchange 2007Exchange 2007
Operação EmptyFolderEmptyFolder operation
Exchange 2010Exchange 2010
Operação FindFolderFindFolder operation
Exchange 2007Exchange 2007
Operação GetFolderGetFolder operation
Exchange 2007Exchange 2007
Operação MoveFolderMoveFolder operation
Exchange 2007Exchange 2007
Operação UpdateFolderUpdateFolder operation
Exchange 2007Exchange 2007

A tabela a seguir lista as operações de anexo de dados da caixa de correio do Exchange.The following table lists the Exchange mailbox data attachment operations.

Nome da operaçãoOperation name Introduzido noIntroduced in
Operação CreateAttachmentCreateAttachment operation
Exchange 2007Exchange 2007
Operação GetAttachmentGetAttachment operation
Exchange 2007Exchange 2007
Operação DeleteAttachmentDeleteAttachment operation
Exchange 2007Exchange 2007

A tabela a seguir lista as operações de lembrete da caixa de correio do Exchange.The following table lists the Exchange mailbox reminder operations.

Nome da operaçãoOperation name Introduzido noIntroduced in
Operação getlembretesGetReminders operation
Exchange 2013Exchange 2013
Operação PerformReminderActionPerformReminderAction operation
Exchange 2013Exchange 2013

A tabela a seguir lista as operações de conversa de dados de caixa de correio do Exchange.The following table lists the Exchange mailbox data conversation operations.

Nome da operaçãoOperation name Introduzido noIntroduced in
Operação ApplyConversationActionApplyConversationAction operation
Exchange 2010 Service Pack 1 (SP1)Exchange 2010 Service Pack 1 (SP1)
Operação FindConversationFindConversation operation
Exchange 2010 SP1Exchange 2010 SP1
Operação GetConversationItemsGetConversationItems operation
Exchange 2013Exchange 2013

A tabela a seguir lista as operações dos utilitários de dados de caixa de correio do Exchange.The following table lists the Exchange mailbox data utilities operations.

Nome da operaçãoOperation name Introduzido noIntroduced in
Operação convertidConvertId operation
Exchange 2007 Service Pack 1Exchange 2007 Service Pack 1
Operação ExpandDLExpandDL operation
Exchange 2007Exchange 2007
Operação GetUserPhotoGetUserPhoto operation
Exchange 2013.Exchange 2013. Essa operação tem uma implementação REST e SOAP.This operation has both a REST and a SOAP implementation.
Operação MarkAsJunkMarkAsJunk operation
Exchange 2013Exchange 2013
Operação ResolveNamesResolveNames operation
Exchange 2007Exchange 2007
Operação GetPasswordExpirationDateGetPasswordExpirationDate operation
Exchange 2010 SP1Exchange 2010 SP1

Operações de disponibilidadeAvailability operations

As operações de disponibilidade aprimoram o calendário e a experiência de compartilhamento de disponibilidade fornecendo informações mais seguras, atualizadas e de disponibilidade avançadas.The availability operations improve the calendar and free/busy sharing experience by providing more secure, up-to-date, and rich free/busy information. Os dados de disponibilidade são um componente crítico do agendamento de reuniões.Free/busy data is a critical component of scheduling meetings. As operações de disponibilidade fornecem uma base confiável para o agendamento efetivo.The availability operations provide a reliable foundation for effective scheduling.

A tabela a seguir lista as operações de disponibilidade.The following table lists the availability operations.

Nome da operaçãoOperation name Introduzido noIntroduced in
Operação GetUserAvailabilityGetUserAvailability operation
Exchange 2007Exchange 2007
Operação GetRoomListsGetRoomLists operation
Exchange 2010Exchange 2010
Operação getroomsGetRooms operation
Exchange 2010Exchange 2010
Operação GetUserOofSettingsGetUserOofSettings operation
Exchange 2007Exchange 2007
Operação SetUserOofSettingsSetUserOofSettings operation
Exchange 2007Exchange 2007

Operações de transferência em massaBulk transfer operations

As operações de transferência em massa permitem que os clientes transmitam itens para dentro e para fora de uma caixa de correio.The bulk transfer operations enable clients to stream items into and out of a mailbox.

A tabela a seguir lista as operações de transferência em massa.The following table lists the bulk transfer operations.

Nome da operaçãoOperation name Introduzido noIntroduced in
Operação UploadItemsUploadItems operation
Exchange 2010 SP1Exchange 2010 SP1
Operação ExportItemsExportItems operation
Exchange 2010 SP1Exchange 2010 SP1

Delegar operações de gerenciamentoDelegate management operations

As operações de gerenciamento de representante permitem que os clientes adicionem, obtenham, atualizem e removam representantes de suas caixas de correio.The delegate management operations enable clients to add, get, update, and remove delegates from their mailboxes.

A tabela a seguir lista as operações de gerenciamento de representante.The following table lists the delegate management operations.

Nome da operaçãoOperation name Introduzido noIntroduced in
Operação AddDelegateAddDelegate operation
Exchange 2007 Service Pack 1 (SP1)Exchange 2007 Service Pack 1 (SP1)
Operação getdelegateGetDelegate operation
Exchange 2007 SP1Exchange 2007 SP1
Operação UpdateDelegateUpdateDelegate operation
Exchange 2007 SP1Exchange 2007 SP1
Operação RemoveDelegateRemoveDelegate operation
Exchange 2007 SP1Exchange 2007 SP1

Operações de regras de caixa de entradaInbox rules operations

As operações de regras de caixa de entrada permitem aos clientes obter as regras de caixa de entrada e atualizá-las para mensagens no servidor.The Inbox rules operations enable clients to get Inbox rules and update them for messages on the server. As regras de caixa de entrada são conjuntos de condições e ações associadas que permitem que os clientes organizem, categorizem e atuem automaticamente as mensagens, conforme as mensagens são entregues a uma pasta.Inbox rules are sets of conditions and associated actions that enable clients to automatically organize, categorize, and act on messages as the messages are delivered to a folder.

A tabela a seguir lista as operações de regras de caixa de entrada.The following table lists the Inbox rules operations.

Nome da operaçãoOperation name Introduzido noIntroduced in
Operação GetInboxRulesGetInboxRules operation
Exchange 2010 SP1Exchange 2010 SP1
Operação UpdateInboxRulesUpdateInboxRules operation
Exchange 2010 SP1Exchange 2010 SP1

Operações de gerenciamento de aplicativos de emailMail app management operations

As operações de gerenciamento de aplicativos de email permitem gerenciar aplicativos de email para o Outlook.The mail app management operations enable you to manage mail apps for Outlook. Você pode usar essas operações para instalar, desinstalar, desabilitar e obter informações sobre aplicativos de email disponíveis para o Outlook Web App e o Outlook 2013.You can use these operations to install, uninstall, disable, and get information about mail apps that are available for Outlook Web App and Outlook 2013.

A tabela a seguir lista as operações de gerenciamento de aplicativos de email.The following table lists the mail app management operations.

Nome da operaçãoOperation name Introduzido noIntroduced in
Operação DisableAppDisableApp operation
Exchange 2013Exchange 2013
Operação GetAppManifestsGetAppManifests operation
Exchange 2013Exchange 2013
Operação GetAppMarketplaceUrlGetAppMarketplaceUrl operation
Exchange 2013Exchange 2013
Operação GetClientAccessTokenGetClientAccessToken operation
Exchange 2013Exchange 2013
Operação InstallAppInstallApp operation
Exchange 2013Exchange 2013
Operação UninstallAppUninstallApp operation
Exchange 2013Exchange 2013

Operação de dicas de emailMail tips operation

A operação de dicas de email permite que os clientes solicitem informações do servidor sobre caixas de correio de destinatário quando um autor estiver redigindo uma mensagem.The mail tips operation enables clients to request information from the server about recipient mailboxes when an author is composing a message. A tabela a seguir lista a operação de dicas de email.The following table lists the mail tips operation.

Nome da operaçãoOperation name Introduzido noIntroduced in
OperaçãoGetMailTips operation
Exchange 2010Exchange 2010

Operações de controle de mensagensMessage tracking operations

As operações de controle de mensagens permitem que os clientes encontrem mensagens que atendem a critérios específicos e obtenham informações de controle detalhadas sobre cada mensagem em um relatório de controle de mensagens.The message tracking operations enable clients to find messages that meet specified criteria and to get detailed tracking information about each message in a message tracking report.

A tabela a seguir lista as operações de controle de mensagens.The following table lists the message tracking operations.

Nome da operaçãoOperation name Introduzido noIntroduced in
Operação FindMessageTrackingReportFindMessageTrackingReport operation
Exchange 2010Exchange 2010
Operação GetMessageTrackingReportGetMessageTrackingReport operation
Exchange 2010Exchange 2010

Operações de notificaçãoNotification operations

As operações de notificação notificam o aplicativo cliente de eventos que estão associados a itens e pastas uma caixa de correio especificada.The notification operations notify the client application of events that are associated with items and folders a specified mailbox. O modelo de assinatura pode ser baseado em força, recepção ou baseado em streaming.The subscription model can be push-based, pull-based, or streaming-based.

A tabela a seguir lista as operações de notificação.The following table lists the notification operations.

Nome da operaçãoOperation name Introduzido noIntroduced in
Operação GetEventsGetEvents operation
Exchange 2007Exchange 2007
Operação GetStreamingEventsGetStreamingEvents operation
Exchange 2010 SP1Exchange 2010 SP1
Operação SubscribeSubscribe operation
Exchange 2007Exchange 2007
Cancelar a operaçãoUnsubscribe operation
Exchange 2007Exchange 2007

Operações personaPersona operations

As operações persona fornecem uma interface para localizar e obter informações sobre um contato vinculado.The persona operations provide an interface to find and get information about a linked contact. A tabela a seguir lista as operações persona.The following table lists the persona operations.

Nome da operaçãoOperation name Introduzido noIntroduced in
Operação FindPeopleFindPeople operation
Exchange 2013Exchange 2013
Operação getpersonaGetPersona operation
Exchange 2013Exchange 2013

Operação de política de retençãoRetention policy operation

A operação de política de retenção fornece uma lista de todas as marcas de retenção vinculadas à política de retenção de um usuário.The retention policy operation provides a list of all the retention tags that are linked to a user's retention policy.

A tabela a seguir lista a operação de política de retenção.The following table lists the retention policy operation.

Nome da operaçãoOperation name Introduzido noIntroduced in
Operação GetUserRetentionPolicyTagsGetUserRetentionPolicyTags operation
Exchange 2013Exchange 2013

Operação de configuração de serviçoService configuration operation

A operação de configuração do serviço permite que os clientes obtenham informações de configuração para a Unificação de mensagens, regras de proteção, dicas de política e serviços de dicas de email.The service configuration operation enables clients to get configuration information for the Unified Messaging, Protection Rules, Policy Tips, and Mail Tips services.

A tabela a seguir lista a operação de configuração do serviço.The following table lists the service configuration operation.

Nome da operaçãoOperation name Introduzido noIntroduced in
Operação GetServiceConfigurationGetServiceConfiguration operation
Exchange 2010Exchange 2010

Operações de compartilhamentoSharing operations

As operações de compartilhamento permitem que os clientes compartilhem dados de calendário e de contatos.The sharing operations enable clients to share calendar data and contacts data.

A tabela a seguir lista as operações de compartilhamento.The following table lists the sharing operations.

Nome da operaçãoOperation name Introduzido noIntroduced in
CreateItem (AcceptSharingInvitation)CreateItem (AcceptSharingInvitation)
Exchange 2010.Exchange 2010. Embora a operação CreateItem seja aplicável a todas as versões do EWS, o objeto de resposta AcceptSharingInvitation só é aplicável ao EWS nas versões do Exchange a partir do Exchange 2010.Although the CreateItem operation is applicable to all versions of EWS, the AcceptSharingInvitation response object is only applicable to EWS in versions of Exchange starting with Exchange 2010.
Operação GetSharingFolderGetSharingFolder operation
Exchange 2010Exchange 2010
Operação GetSharingMetadataGetSharingMetadata operation
Exchange 2010Exchange 2010
Operação RefreshSharingFolderRefreshSharingFolder operation
Exchange 2010Exchange 2010

Operações de sincronizaçãoSynchronization operations

As operações de sincronização fornecem uma cópia em cache sincronizada unidirecional de pastas e itens de um usuário.The synchronization operations provide a one-way synchronized cached copy of a user's folders and items.

A tabela a seguir lista as operações de sincronização.The following table lists the synchronization operations.

Nome da operaçãoOperation name Introduzido noIntroduced in
Operação SyncFolderHierarchySyncFolderHierarchy operation
Exchange 2007Exchange 2007
Operação SyncFolderItemsSyncFolderItems operation
Exchange 2007Exchange 2007

Operação de fuso horárioTime zone operation

A operação de fuso horário permite que os clientes obtenham uma lista de definições de fuso horário compatíveis com o servidor.The time zone operation enables clients to get a list of time zone definitions that are supported by the server.

A tabela a seguir lista a operação de fuso horário.The following table lists the time zone operation.

Nome da operaçãoOperation name Introduzido noIntroduced in
Operação GetServerTimeZonesGetServerTimeZones operation
Exchange 2010Exchange 2010

Operações de Unificação de mensagensUnified Messaging operations

As operações de Unificação de mensagens permitem que os clientes leiam informações sobre as propriedades da Unificação de mensagens e reproduzam mensagens de caixa postal por telefone.The Unified Messaging operations enable clients to read information about Unified Messaging properties and to play voice mail messages over the phone.

A tabela a seguir lista as operações de Unificação de mensagens.The following table lists the Unified Messaging operations.

Nome da operaçãoOperation name Introduzido noIntroduced in
Operação DisconnectPhoneCallDisconnectPhoneCall operation
Exchange 2010Exchange 2010
Operação GetPhoneCallInformationGetPhoneCallInformation operation
Exchange 2010Exchange 2010
Operação PlayOnPhone (EWS)PlayOnPhone operation (EWS)
Exchange 2010Exchange 2010

Use a operação GetServiceConfiguration para obter as informações de configuração de Unificação de mensagens para uma caixa de correio.Use the GetServiceConfiguration operation to get the Unified Messaging configuration information for a mailbox. Use o serviço Web de Unificação de mensagens para aplicativos de Unificação de mensagens direcionados ao Exchange 2007.Use the Unified Messaging web service for Unified Messaging applications that target Exchange 2007. Para obter mais informações, consulte Unified Messaging Web Service Reference for Exchange.For more information, see Unified Messaging web service reference for Exchange.

Operações do repositório unificado de contatosUnified Contact Store operations

O repositório unificado de contatos fornece uma experiência de contato consistente entre os produtos do Office e atua como um ponto de integração para aplicativos de terceiros usarem o mesmo repositório de contatos.The Unified Contact Store provides a consistent contact experience across Office products and acts as an integration point for third-party applications to use the same contact store. Ele permite que os usuários e aplicativos armazenem, gerenciem e acessem informações de contato e o disponibilizem globalmente entre o Lync, o Exchange 2013, o Outlook, o Outlook Web App e qualquer outro aplicativo que implemente o acesso ao repositório unificado de contatos.It enables users and applications to store, manage, and access contact information and make it available globally among Lync, Exchange 2013, Outlook, Outlook Web App, and any other application that implements access to the Unified Contact Store. O Exchange é o repositório de conteúdo para a experiência do repositório unificado de contatos.Exchange is the content store for the Unified Contact Store experience.

A tabela a seguir lista as operações do repositório unificado de contatos.The following table lists the Unified Contact Store operations.

Nome da operaçãoOperation name Introduzido noIntroduced in
Operação AddNewImContactToGroupAddNewImContactToGroup operation
Exchange 2013Exchange 2013
Operação AddImContactToGroupAddImContactToGroup operation
Exchange 2013Exchange 2013
Operação AddImGroupAddImGroup operation
Exchange 2013Exchange 2013
Operação AddNewTelUriContactToGroupAddNewTelUriContactToGroup operation
Exchange 2013Exchange 2013
Operação AddDistributionGroupToImListAddDistributionGroupToImList operation
Exchange 2013Exchange 2013
Operação GetImItemListGetImItemList operation
Exchange 2013Exchange 2013
Operação GetImItemsGetImItems operation
Exchange 2013Exchange 2013
Operação RemoveContactFromImListRemoveContactFromImList operation
Exchange 2013Exchange 2013
Operação RemoveImContactFromGroupRemoveImContactFromGroup operation
Exchange 2013Exchange 2013
Operação RemoveDistributionGroupFromImListRemoveDistributionGroupFromImList operation
Exchange 2013Exchange 2013
Operação RemoveImGroupRemoveImGroup operation
Exchange 2013Exchange 2013
Operação SetImGroupSetImGroup operation
Exchange 2013Exchange 2013

Operações de configuração do usuárioUser configuration operations

As operações de configuração do usuário permitem que os clientes criem, excluam, obtenham e atualizem as informações de configuração do usuário.The user configuration operations enable clients to create, delete, get, and update user configuration information.

A tabela a seguir lista as operações de configuração do usuário.The following table lists the user configuration operations.

Nome da operaçãoOperation name Introduzido noIntroduced in
Operação CreateUserConfigurationCreateUserConfiguration operation
Exchange 2010Exchange 2010
Operação DeleteUserConfigurationDeleteUserConfiguration operation
Exchange 2010Exchange 2010
Operação GetUserConfigurationGetUserConfiguration operation
Exchange 2010Exchange 2010
Operação UpdateUserConfigurationUpdateUserConfiguration operation
Exchange 2010Exchange 2010

Confira tambémSee also