Eliminación de elementos mediante EWS en ExchangeDeleting items by using EWS in Exchange

Descubra cómo puede usar la API administrada de EWS o EWS en Exchange para eliminar elementos moviéndolos a la carpeta elementos eliminados o al contenedor.Find out how you can use the EWS Managed API or EWS in Exchange to delete items either by moving them to the Deleted Items folder or to the dumpster.

¿Se ha preguntado alguna vez cuál es la diferencia entre mover elementos a la carpeta elementos eliminados y moverlos al contenedor?Have you ever asked yourself what the difference is between moving items to the Deleted Items folder, and moving them to the dumpster? Puede ser curioso sobre las distintas opciones para controlar los elementos eliminados y cómo implementar dichas opciones en la aplicación.You might be curious about the different options for handling deleted items and how to implement those options in your application. Los servicios web Exchange (EWS) incluyen tres opciones para el tratamiento de elementos eliminados.Exchange Web Services (EWS) includes three options for handling deleted items. Es muy probable que, en este artículo, se borre cualquier confusión que pueda tener acerca de las diferencias entre ellos.This article will hopefully clear up any confusion you might have about the differences between them.

Eliminar elementos: ¿Cuáles son mis opciones?Deleting items - what are my options?

Antes de comprender el panorama general para eliminar elementos, es importante que reconozca la diferencia entre lo siguiente:Before you can understand the overall landscape for deleting items, it's important to recognize the difference between the following:

  • La carpeta elementos eliminados: cuando se eliminan elementos en un buzón de correo, aquí es donde van.The Deleted Items folder - When you delete items in a mailbox, this is where they go.

  • El contenedor (también conocido como carpeta de elementos recuperables) cuando se quitan elementos de un buzón de correo, aquí es donde van.The dumpster (aka the Recoverable Items folder) - When you remove items from a mailbox, this is where they go.

Las figuras 1 y 2 muestran el aspecto que tiene el proceso de eliminación para los elementos y las carpetas de un buzón de correo.Figures 1 and 2 show what the deletion process looks like for items and folders in a mailbox.

Figura 1. Proceso para eliminar elementos de un buzón de correoFigure 1. Process for deleting items from a mailbox

Ilustración que muestra a dónde van los elementos cuando se eliminan.


Figura 2. Proceso para eliminar carpetas de un buzónFigure 2. Process for deleting folders from a mailbox

Ilustración que muestra cómo las carpetas eliminadas se mueven a la carpeta Elementos eliminados y luego pueden eliminarse de manera permanente del buzón de correo.

Puede eliminar los elementos y las carpetas de tres maneras diferentes, en función de la "permanente" que desea que se elimine.You can delete items and folders three different ways, depending on how "permanent" you would like the deletion to be.

Tabla 1: opciones para eliminar elementos mediante EWSTable 1: Options for deleting items by using EWS

OpciónOption Qué ocurreWhat happens
Mover a la carpeta Elementos eliminadosMove to the Deleted Items folder
Esta es la forma menos permanente de eliminar elementos.This is the least permanent way to delete items.

Esto es similar a colocar una hoja de papel en la papelera de reciclaje de su escritorio.This is like putting a piece of paper in the recycle bin by your desk. Puede tomarla fácilmente si es necesario.You can easily grab it if you need it again.

Puede usar cualquier operación de eliminación que implemente la opción mover a la carpeta elementos eliminados para realizar esta acción.You can use any deletion operation that implements the move to the Deleted Items folder option to perform this action.

También puede usar la operación MoveItem ( Item. Move ()) o la operación MoveFolder ( Folder. Move ()) para mover un elemento o una carpeta a la carpeta elementos eliminados.You can also use the MoveItem operation ( Item.Move()) or the MoveFolder operation ( Folder.Move()) to move an item or folder to the Deleted Items folder.
Eliminar temporalmenteSoft delete
El elemento se mueve a la carpeta eliminaciones del contenedor.The item is moved to the Deletions folder in the dumpster.

Esto es como vaciar la papelera de reciclaje en el contenedor Curbside.This is like emptying your recycle bin into your curbside container. Todavía puede tener acceso al elemento si es necesario, es un poco más difícil.You can still access the item if you need to, it's just a little harder.

Para obtener más información sobre el contenedor (también denominado la carpeta elementos recuperables) y escenarios como eDiscovery o retenciones por juicio, consulte Recoverable items Folder en TechNet.For more about the dumpster (also called the Recoverable Items folder) and scenarios such as eDiscovery or litigation holds, see Recoverable Items Folder on TechNet.

No se recomiendan las eliminaciones de software para las aplicaciones destinadas a Exchange 2007.Soft deletions aren't recommended for applications that target Exchange 2007. En Exchange 2007, las eliminaciones de software se administran estableciendo un bit en el elemento para indicar que se moverá al contenedor en un momento no especificado.In Exchange 2007, soft deletions are handled by setting a bit on the item to indicate that it will be moved to the dumpster at an unspecified time.

Los recorridos de eliminación de software, o búsquedas de elementos que se han eliminado de forma parcial mediante la operación FindItem, no son compatibles con Exchange Online, Exchange online como parte de Office 365 y las versiones de Exchange que comienzan con Exchange 2010.Soft delete traversals, or searches of items that have been soft deleted via the FindItem operation, are not supported in Exchange Online, Exchange Online as part of Office 365, and versions of Exchange starting with Exchange 2010.

Nota: las carpetas no se pueden eliminar temporalmente.NOTE: Folders cannot be soft deleted.
Eliminar de forma permanenteHard delete
El elemento o carpeta se elimina de forma permanente.The item or folder is permanently deleted.

Los elementos eliminados permanentemente se colocan en la carpeta purgas del contenedor.Hard-deleted items are placed in the Purges folder of the dumpster. Esto es como cuando el camión de reciclaje vacía el contenedor de reciclaje de Curbside.This is like when the recycling truck empties your curbside recycle container. No se puede acceder a los elementos desde un cliente de correo electrónico como Outlook o Outlook Web App y, a menos que haya un conjunto de suspensión en el buzón, los elementos se eliminarán permanentemente después de un período de tiempo establecido.The items cannot be accessed from an email client like Outlook or Outlook Web App, and, unless there is a hold set on the mailbox, the items will be permanently deleted after a set period of time.

Para obtener más información acerca de la retención de elementos, vea el artículo configurar la retención de elementos eliminados y las cuotas de elementos recuperables.You can read more about item retention in the article Configure Deleted Item Retention and Recoverable Items Quotas.

Nota: las carpetas no se colocan en la carpeta purgadores cuando se eliminan de forma permanente.NOTE: Folders are not placed in the Purges folder when they are hard deleted. Las carpetas eliminadas permanentemente se quitan del buzón de correo.Hard-deleted folders are removed from the mailbox.

La carpeta mover a la carpeta elementos eliminados y las opciones para eliminar permanentemente son transaccionales, lo que significa que, en el momento en que finaliza la llamada al servicio Web, el elemento se movió a la carpeta elementos eliminados o al contenedor.The move to the Deleted Items folder and the hard delete options are transactional, which means that by the time the web service call finishes, the item has been moved to the Deleted Items folder or the dumpster.

Para ayudarle a comprender mejor el ecosistema de las carpetas que se usan para almacenar los elementos eliminados, en la siguiente figura se muestra la jerarquía de carpetas que pueden contener elementos eliminados.To help you better understand the ecosystem of folders that are used to store deleted items, the following figure shows the hierarchy of folders that can contain deleted items. Los nombres de carpeta son los que aparecen en el tipo de esquema DistinguishedFolderIdNameType o la enumeración WELLKNOWNFOLDERNAME en la API administrada de EWS.The folder names are as they appear in the DistinguishedFolderIdNameType schema type, or the WellKnownFolderName enumeration in the EWS Managed API.

Figura 3. Jerarquía de carpetas que contienen elementos eliminadosFigure 3. Hierarchy of folders that contain deleted items

Figura que muestra la jerarquía de carpetas de las carpetas que pueden contener elementos eliminados en un buzón de correo principal y de archivo. Cada carpeta de la imagen se representa con su nombre de carpeta distintivo.

Tabla 2: carpetas que contienen elementos eliminadosTable 2: Folders that contain deleted items

Nombre de carpetaFolder name Introducido enIntroduced in DescripciónDescription
deleteditemsdeleteditems
Exchange 2007Exchange 2007
Carpeta elementos eliminados predeterminada.The default Deleted Items folder. Los elementos permanecen en esta carpeta hasta que se eliminan temporalmente o de forma permanente, o hasta que se supera un período de retención.Items remain in this folder until they are soft- or hard-deleted or until a retention period has been exceeded. A continuación, se mueven a una carpeta del contenedor.Then they are moved to a folder in the dumpster. Las carpetas eliminadas se colocan en la carpeta elementos eliminados y, cuando se eliminan temporalmente o de forma permanente, se quitan permanentemente del buzón y no se pueden recuperar.Deleted folders are placed in the Deleted Items folder, and when they are soft- or hard-deleted, they are permanently removed from the mailbox and are not recoverable.
recoverableitemsrootrecoverableitemsroot
Exchange 2010Exchange 2010
La raíz del contenedor o la carpeta elementos recuperables.The root of the dumpster, or the Recoverable Items folder. El acceso al contenedor se ha implementado en EWS en Exchange 2010.Dumpster access was implemented in EWS in Exchange 2010. El nombre para mostrar de esta carpeta es "elementos recuperables".The display name for this folder is "Recoverable Items".
recoverableitemsdeletionsrecoverableitemsdeletions
Exchange 2010Exchange 2010
La carpeta de contenedor principal de un buzón de correo.The main dumpster folder for a mailbox. Los elementos eliminados temporalmente y los elementos movidos de la carpeta elementos eliminados por una directiva de retención se colocan en esta carpeta.Soft-deleted items and items moved from the Deleted Items folder by a retention policy are placed in this folder. El nombre para mostrar de esta carpeta es "eliminaciones".The display name for this folder is "Deletions".
recoverableitemsversionsrecoverableitemsversions
Exchange 2010Exchange 2010
Donde se almacenan versiones anteriores de un elemento.Where older versions of an item are stored. Las versiones anteriores de un elemento se crean cuando se actualiza un elemento.Old versions of an item are created when an item is updated. Las versiones de borrador de elemento no se guardan en esta carpeta.Draft item versions are not saved to this folder. El nombre para mostrar de esta carpeta es "versiones".The display name of this folder is "Versions".
recoverableitemspurgesrecoverableitemspurges
Exchange 2010Exchange 2010
Dónde se almacenan los elementos que se quitan de la carpeta eliminaciones.Where items that are removed from the Deletions folder are stored. Todos los elementos eliminados permanentemente de la tienda se mueven a esta carpeta.All store hard-deleted items are moved to this folder. El nombre para mostrar de esta carpeta es "purgados".The display name for this folder is "Purges".
archiveddeletedtitemsarchiveddeletedtitems
Exchange 2010Exchange 2010
La carpeta elementos eliminados predeterminada para un buzón de archivo.The default Deleted Items folder for an archive mailbox.
archiverecoverablesitemsrootarchiverecoverablesitemsroot
Exchange 2010Exchange 2010
La carpeta raíz del contenedor de un buzón de archivo.The root dumpster folder for an archive mailbox. Los elementos archivados que se eliminan temporalmente se mueven a una subcarpeta de esta carpeta.Archived items that are soft-deleted are moved to a subfolder in this folder.
archiverecoverableitemsdeletionsarchiverecoverableitemsdeletions
Exchange 2010Exchange 2010
La carpeta de contenedor principal para un buzón de archivo.The main dumpster folder for an archive mailbox. Los elementos archivados que se mueven al contenedor se colocan aquí.Archived items moved to the dumpster are placed here.
archiverecoverableitemsversionsarchiverecoverableitemsversions
Exchange 2010Exchange 2010
Donde se almacenan versiones anteriores de los elementos archivados.Where older versions of archived items are stored.
archiverecoverableitemspurgesarchiverecoverableitemspurges
Exchange 2010Exchange 2010
Dónde se almacenan los elementos que se eliminan de forma permanente de la carpeta eliminaciones de archivo en el contenedor.Where items that are hard-deleted from the archive Deletions folder in the dumpster are stored. Todos los elementos archivados eliminados permanentemente se mueven a esta carpeta.All store hard-deleted archived items are moved to this folder.

¿Cómo se eliminan los elementos?How do I delete items?

Use una de las siguientes opciones para indicar si se debe mover un elemento a la carpeta elementos eliminados o realizar una eliminación temporal o una eliminación de hardware:Use one of the following to indicate whether to move an item to the Deleted Items folder or perform a soft delete or a hard delete:

  • El tipo simple DisposalType , si usa EWS para tener acceso a Exchange.The DisposalType simple type, if you use EWS to access Exchange.

  • La enumeración DeleteMode, si usa la API administrada de EWS.The DeleteMode enumeration, if you use the EWS Managed API.

Puede usar varias operaciones de EWS o métodos de API administrada de EWS para eliminar elementos y carpetas de un buzón.You can use a number of different EWS operations or EWS Managed API methods to delete items and folders from a mailbox.

Tabla 3: operaciones de EWS y métodos de API administrada de EWS para eliminar elementosTable 3: EWS operations and EWS Managed API methods for deleting items

Operación de EWSEWS operation Método de la API administrada de EWSEWS Managed API method Introducido enIntroduced in Qué haceWhat it does
Operación DeleteFolderDeleteFolder operation
Método Folder. DeleteFolder.Delete method
Exchange 2007Exchange 2007
Elimina carpetas de un buzón.Deletes folders from a mailbox. Con EWS, puede eliminar las carpetas por lotes.With EWS, you can batch delete folders. Con la API administrada de EWS, solo puede eliminar una carpeta única por llamada.With the EWS Managed API, you can only delete a single folder per call.
Operación DeleteItemDeleteItem operation
Método Item. DeleteItem.Delete method

Método ExchangeService. DeleteItemsExchangeService.DeleteItems method
Exchange 2007Exchange 2007
Elimina elementos de un buzón de correo.Deletes items from a mailbox.
Operación EmptyFolderEmptyFolder operation
Método Folder. EmptyFolder.Empty method
Exchange 2010Exchange 2010
Elimina todos los elementos de una carpeta y, opcionalmente, elimina todas las subcarpetas de una carpeta.Deletes all the items in a folder, and, optionally, deletes all subfolders in a folder.
Operación ApplyConversationActionApplyConversationAction operation
Método Conversation. EnableAlwaysDeleteItemsConversation.EnableAlwaysDeleteItems method

Método Conversation. DeleteItemsConversation.DeleteItems method
Exchange 2010Exchange 2010
Establece una acción de procesamiento de eliminación en los mensajes de correo electrónico de una conversación para que se eliminen.Sets a delete processing action on email messages in a conversation so that they are deleted.
Operación DeleteUserConfigurationDeleteUserConfiguration operation
Método UserConfiguration. DeleteUserConfiguration.Delete method
Exchange 2010Exchange 2010
Elimina un elemento asociado a la carpeta y lo mueve al contenedor.Deletes a folder associated item and moves it to the dumpster.
Operación CreateItemCreateItem operation
Método appointment. AcceptAppointment.Accept method

Método appointment. AcceptTentativelyAppointment.AcceptTentatively method

Método appointment. CancelMeetingAppointment.CancelMeeting method

Appointment. declinarAppointment.Decline

Método MeetingRequest. AcceptMeetingRequest.Accept method

Método MeetingRequest. AcceptTentativelyMeetingRequest.AcceptTentatively method

Método MeetingRequest. declineMeetingRequest.Decline method
Exchange 2007Exchange 2007
Mueve indirectamente un elemento a la carpeta elementos eliminados cuando se envía una respuesta a una convocatoria de reunión o cuando se establece la respuesta en la cita.Indirectly moves an item to the Deleted Items folder whenever a response to a meeting request is sent or the response is set on the appointment.

No se ha establecido el tipo de eliminación en esta operación.The deletion type is not set on this operation. Los mensajes de reunión se mueven a la carpeta elementos eliminados cuando el servicio procesa correctamente un objeto de respuesta.The meeting messages are moved to the Deleted Items folder when a response object is successfully processed by the service.

También puede mover elementos a la carpeta elementos eliminados mediante reglas de la bandeja de entrada.You can also move items to the Deleted Items folder by using Inbox rules. Por ejemplo, puede crear reglas que tengan una acción de eliminación.For example, you can create rules that have a delete action.

Algunos puntos que tener en cuenta sobre la eliminación de elementos:Some points to note about deleting items:

  • La eliminación de una ocurrencia de un elemento periódico no desencadena un movimiento a la carpeta elementos eliminados o al contenedor.Deleting an occurrence of a recurring item does not trigger a move to the Deleted Items folder or the dumpster. Esto da como resultado una actualización del elemento maestro periódico de la serie periódica.This results in an update to the recurring master item of the recurring series.

  • No se pueden eliminar las carpetas predeterminadas del buzón.You cannot delete default folders from the mailbox.

  • Evite eliminar reuniones o mensajes de reunión, como solicitudes de reunión o actualizaciones de reuniones.Avoid deleting meetings or meeting messages, such as meeting requests and or meeting updates. En su lugar, responda a estos elementos mediante objetos Response.Instead, respond to these items by using response objects. De esta forma, los elementos de calendario asociados se actualizan para reflejar las acciones del persona que responde o el organizador.This way, the associated calendar items are updated to reflect the responder's or organizer's actions.

  • La clave de cambio de un elemento no se actualiza cuando el elemento se mueve a la carpeta elementos eliminados o eliminados.An item's change key is not updated when the item is moved to the Deleted Items or Deletions folder.

  • Si realiza una eliminación dura en un elemento y después llama a una operación de SyncFolderHierarchy o SYNCFOLDERHIERARCHY método de API administrada de EWS, o a una operación SyncFolderItems o a un método SyncFolderItems , se devolverá una entrada de cambio de eliminación .If you perform a hard delete on an item and then call a SyncFolderHierarchy operation or SyncFolderHierarchy EWS Managed API method, or a SyncFolderItems operation or SyncFolderItems method, a Delete change entry will be returned. Si mueve un elemento a la carpeta elementos eliminados, se devuelve una entrada de cambio de actualización .If you move an item to the Deleted Items folder, an Update change entry is returned. Esto se debe a que el elemento o carpeta tendrá un nuevo valor de la propiedad ParentFolderId .This is because the item or folder will have a new ParentFolderId property value. Obtenga más información acerca de la sincronización si la sincronización de elementos eliminados forma parte de su escenario.Read more about synchronization if synchronizing deleted items is part of your scenario.

Obtener más información sobre cómo eliminar elementosFind out more about deleting items

Vea tambiénSee also