Compartir a través de

Get-RecoverableItems

Módulo:
Exchange PowerShell

Este cmdlet está disponible en Exchange local y en el servicio basado en la nube. Algunos parámetros y configuraciones pueden ser 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.

Sintaxis

OnPremises 

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

Cloud 

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

Description

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este artículo se enumeran todos los parámetros del cmdlet, es posible que no tenga acceso a algunos parámetros si no se incluyen en los permisos que se le asignan. 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

Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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.).

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-FilterEndTime

Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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/aaaa, 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".

Propiedades de parámetro

Tipo:DateTime
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-FilterItemType

Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-FilterStartTime

Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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/aaaa, 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".

Propiedades de parámetro

Tipo:DateTime
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Identity

Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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".

Precaución: El valor $null o un valor inexistente para el parámetro Identity devuelve todos los objetos como si ejecutara el comando Get- sin el parámetro Identity. Compruebe que las listas de valores del parámetro Identity son precisas y no contienen valores $null inexistentes.

Propiedades de parámetro

Tipo:GeneralMailboxOrMailUserIdParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

OnPremises
Posición:1
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
Cloud
Posición:1
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-LastParentFolderID

Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-MaxParallelSize

Aplicable: Exchange Online

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.

Propiedades de parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Cloud
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-PolicyTag

Aplicable: Exchange Online

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

{{ Fill PolicyTag Description }}

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Cloud
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ResultSize

Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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.

Propiedades de parámetro

Tipo:Unlimited
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SkipCount

Aplicable: Exchange Online

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

{{ Fill SkipCount Description }}

Propiedades de parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SourceFolder

Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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 busca en esas tres carpetas.

  • DiscoveryHoldsItems (solo en la nube): 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.

Propiedades de parámetro

Tipo:RecoverableItemsFolderType
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SubjectContains

Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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 (").

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.