Share via


Get-RecoverableItems

Este cmdlet está disponible en Exchange local y en el servicio basado en la nube. Puede que algunos parámetros y opciones de configuración sean exclusivos de un entorno u otro.

Use el cmdlet Get-RecoverableItems items para ver los elementos eliminados en los buzones de correo. Cuando encuentre los elementos eliminados, use el cmdlet Restore-RecoverableItems para restaurarlos.

Este cmdlet solo está disponible en el rol Exportación de importación de buzones y, de forma predeterminada, el rol no está asignado a ningún grupo de roles. Para usar este cmdlet, deberá agregar el rol de importación y exportación de buzón de correo a un grupo de roles (por ejemplo, al grupo de roles de administración de la organización). Para obtener más información, vea Agregar un rol a un grupo de roles.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Syntax

Get-RecoverableItems
   -Identity <GeneralMailboxOrMailUserIdParameter>
   [-EntryID <String>]
   [-FilterEndTime <DateTime>]
   [-FilterItemType <String>]
   [-FilterStartTime <DateTime>]
   [-LastParentFolderID <String>]
   [-ResultSize <Unlimited>]
   [-SourceFolder <RecoverableItemsFolderType>]
   [-SubjectContains <String>]
   [<CommonParameters>]
Get-RecoverableItems
   -Identity <GeneralMailboxOrMailUserIdParameter[]>
   [-EntryID <String>]
   [-FilterEndTime <DateTime>]
   [-FilterItemType <String>]
   [-FilterStartTime <DateTime>]
   [-LastParentFolderID <String>]
   [-MaxParallelSize <Int32>]
   [-PolicyTag <String[]>]
   [-ResultSize <Unlimited>]
   [-SourceFolder <RecoverableItemsFolderType>]
   [-SubjectContains <String>]
   [<CommonParameters>]

Description

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

Ejemplos

Ejemplo 1

Get-RecoverableItems -Identity laura@contoso.com -SubjectContains "FY17 Accounting" -FilterItemType IPM.Note -FilterStartTime "2/1/2018 12:00:00 AM" -FilterEndTime "2/5/2018 11:59:59 PM"

En este ejemplo se devuelven todos los mensajes eliminados recuperables disponibles con el asunto especificado en el buzón laura@contoso.com para el intervalo de fecha y hora especificado.

Ejemplo 2

Get-RecoverableItems -Identity "malik@contoso.com", "lillian@contoso.com" -FilterItemType IPM.Note -FilterStartTime "3/15/2019 12:00:00 AM" -FilterEndTime "3/25/2019 11:59:59 PM"

En este ejemplo se devuelven todos los mensajes eliminados recuperables disponibles con el asunto especificado en los buzones de correo de y malik@contoso.comlillian@contoso.com para el intervalo de fecha y hora especificado.

Parámetros

-EntryID

El parámetro EntryID especifica el elemento eliminado que desea restaurar. El valor entryID del elemento eliminado es único en el buzón.

Puede encontrar entryID para elementos específicos mediante otros filtros de búsqueda en el cmdlet Get-RecoverableItems (asunto, intervalo de fechas, etc.).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-FilterEndTime

FilterEndTime especifica la fecha y hora de finalización del intervalo de fechas. Este parámetro usa el valor LastModifiedTime del elemento.

Use el formato de fecha corta que se define en la opción Configuración regional en el equipo en el que se ejecuta el comando. Por ejemplo, si el equipo está configurado para usar el formato de fecha corta mm/dd/yyyy, escriba 09/01/2018 para especificar el 1 de septiembre de 2018. Puede escribir solo la fecha, o la fecha y la hora del día. Si escribe la fecha y la hora del día, encierre el valor entre comillas ("), por ejemplo, "01/09/2018 5:00 PM".

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-FilterItemType

El parámetro FilterItemType filtra los resultados por el valor de propiedad MessageClass (ItemClass) especificado del elemento eliminado. Por ejemplo:

  • IPM. Cita (reuniones y citas)
  • IPM.Contact
  • IPM. Archivo
  • IPM.Note
  • IPM.Task
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-FilterStartTime

FilterStartTime especifica la fecha y hora de inicio del intervalo de fechas. Este parámetro usa el valor LastModifiedTime del elemento.

Use el formato de fecha corta que se define en la opción Configuración regional en el equipo en el que se ejecuta el comando. Por ejemplo, si el equipo está configurado para usar el formato de fecha corta mm/dd/yyyy, escriba 09/01/2018 para especificar el 1 de septiembre de 2018. Puede escribir solo la fecha, o la fecha y la hora del día. Si escribe la fecha y la hora del día, encierre el valor entre comillas ("), por ejemplo, "01/09/2018 5:00 PM".

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-Identity

El parámetro Identity especifica el buzón de correo que contiene los elementos eliminados que desea ver. Es posible usar cualquier valor que identifique exclusivamente el buzón. Por ejemplo:

  • Nombre
  • Alias
  • Nombre distintivo (DN)
  • Nombre completo (DN)
  • Dominio\Nombre de usuario
  • Dirección de correo electrónico
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuario o nombre de la entidad de seguridad de usuario (UPN)

En Exchange Online, puede especificar varios buzones separados por comas. Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN".

Type:GeneralMailboxOrMailUserIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019

-LastParentFolderID

El parámetro LastParentFolderID especifica el valor FolderID del elemento antes de que se eliminara. Por ejemplo, 53B93149989CA54DBC9702AE619B9CCA00062CE9397.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-MaxParallelSize

Este parámetro solo está disponible en el servicio basado en la nube.

El parámetro MaxParallelSize especifica el número máximo de buzones que procesa el comando en paralelo. Un valor válido es un entero de 1 a 10. Normalmente, un valor mayor reduce la cantidad de tiempo que se tarda en completar el comando en varios buzones de correo.

El valor de este parámetro no tiene ningún efecto cuando el parámetro Identity especifica solo un buzón.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-PolicyTag

Este parámetro solo está disponible en el servicio basado en la nube.

{{ Fill PolicyTag Description }}

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ResultSize

El parámetro ResultSize especifica el número máximo de resultados que se van a devolver. Si desea incluir en los resultados devueltos todas las solicitudes que coincidan con la consulta, use el valor ilimitado para este parámetro. El valor predeterminado es 1000.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-SourceFolder

El parámetro SourceFolder especifica dónde buscar elementos eliminados en el buzón. Los valores admitidos son:

  • DeletedItems: la carpeta Elementos eliminados.

  • RecoverableItems: la carpeta Elementos recuperables\Eliminaciones. Esta carpeta contiene elementos que se han eliminado de la carpeta Elementos eliminados (elementos eliminados temporalmente).

  • PurgedItems: la carpeta Elementos recuperables\Purga. Esta carpeta contiene elementos que se han purgado de la carpeta Elementos recuperables (elementos eliminados de forma rígida).

    Si no usa este parámetro, el comando buscará en estas tres carpetas.

  • DiscoveryHoldsItems: la carpeta Recoverable Items\DiscoveryHolds. Esta carpeta contiene elementos que se han purgado de la carpeta Elementos recuperables (elementos eliminados de forma rígida) y están protegidos por una suspensión. Para buscar elementos eliminados en esta carpeta, use este parámetro con el valor DiscoveryHoldsItems.

Type:RecoverableItemsFolderType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-SubjectContains

El parámetro SubjectContains filtra los elementos por el valor de texto especificado en el campo Asunto. Si el valor contiene espacios, escriba el valor entre comillas (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online