Restore-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 Restore-RecoverableItems elementos para restaurar los elementos eliminados en los buzones. Use el cmdlet Get-RecoverableItems para buscar los elementos eliminados que desea recuperar.

Este cmdlet solo está disponible en el rol de exportación e importación de buzón 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 

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

Cloud 

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

Description

Los elementos se restauran a la ubicación de la carpeta original si la información está disponible para el elemento. Si no se encuentra la información, el elemento se restaura a la carpeta predeterminada para el tipo de elemento (Bandeja de entrada para mensajes, Calendar para reuniones y citas, etc.).

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 tiene asignados. 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

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

Después de usar el cmdlet Get-RecoverableItems para comprobar la existencia del elemento, en este ejemplo se restaura el elemento eliminado especificado del buzón especificado:

  • Buzón: laura@contoso.com
  • Tipo de elemento: mensaje de email
  • Asunto del mensaje: Contabilidad FY18
  • Ubicación: Elementos recuperables\Eliminaciones
  • Intervalo de fechas: 01/02/2018 a 05/02/2018

Ejemplo 2

$mailboxes = Import-CSV "C:\My Documents\RestoreMessage.csv"

$mailboxes | foreach {Restore-RecoverableItems -Identity $_.SMTPAddress -SubjectContains "Project X" -SourceFolder DeletedItems -FilterItemType IPM.Note}

En Exchange Server, en este ejemplo se restaura el mensaje de correo electrónico eliminado "Project X" para los buzones especificados en el archivo de valores separados por comas (CSV) C:\My Documents\RestoreMessage.csv. El archivo CSV usa el valor de encabezado SMTPAddress y contiene la dirección de correo electrónico de cada buzón en una línea independiente como esta:

SMTPAddress
chris@contoso.com
michelle@contoso.com
laura@contoso.com
julia@contoso.com

El primer comando lee el archivo CSV en la variable llamada $mailboxes. El segundo comando restaura el mensaje especificado desde la carpeta Elementos eliminados de esos buzones.

Ejemplo 3

Restore-RecoverableItems -Identity "malik@contoso.com","lillian@contoso.com" -FilterItemType IPM.Note -SubjectContains "COGS FY17 Review" -FilterStartTime "3/15/2019 12:00:00 AM" -FilterEndTime "3/25/2019 11:59:59 PM" -MaxParallelSize 2

En Exchange Online, después de usar el cmdlet Get-RecoverableItems para comprobar la existencia del elemento, en este ejemplo se restauran los elementos eliminados especificados en los buzones especificados:

  • Buzones: malik@contoso.com, lillian@contoso.com
  • Tipo de elemento: mensaje de email
  • Asunto del mensaje: Revisión del año fiscal 2017 de COGS
  • Ubicación: Elementos recuperables\Eliminaciones
  • Intervalo de fechas: 15/03/2019 al 25/03/2019
  • Número de buzones procesados simultáneamente: 2

Ejemplo 4

Get-RecoverableItems administrator | Restore-RecoverableItems

En este ejemplo se restauran de forma masiva todos los elementos recuperables para el administrador.

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 de EntryID para el elemento eliminado es único en el buzón.

Puede encontrar el EntryID de elementos específicos mediante otros filtros de búsqueda en el cmdlet de 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
Mandatory: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
Mandatory: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:

  • MIP. Cita (reuniones y citas)
  • IPM.Contact
  • MIP. 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
Mandatory: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
Mandatory: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 que contiene los elementos eliminados que desea restaurar. 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".

Propiedades de parámetro

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

Conjuntos de parámetros

OnPremises
Posición:1
Mandatory: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
Mandatory: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 elimine. Por ejemplo, 53B93149989CA54DBC9702AE619B9CCA000062CE9397.

Propiedades de parámetro

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

Conjuntos de parámetros

(All)
Posición:Named
Mandatory: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 de correo que el comando procesa en paralelo. Un valor válido es un entero de 1 a 10. Normalmente, un valor más alto reduce la cantidad de tiempo que se tarda en completar el comando en varios buzones.

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
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-NoOutput

Aplicable: Exchange Online

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

El modificador NoOutput restaura los elementos eliminados directamente sin ninguna salida de comando en la consola. No es necesario especificar un valor con este modificador.

Propiedades de parámetro

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

Conjuntos de parámetros

Cloud
Posición:Named
Mandatory: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.

{{ Rellenar descripción de PolicyTag }}

Propiedades de parámetro

Tipo:

String[]

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

Conjuntos de parámetros

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

-RestoreTargetFolder

Aplicable: Exchange Online

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

El parámetro RestoreTargetFolder especifica la carpeta de nivel superior en la que se restaurarán los datos. Si no especifica este parámetro, el comando restaurará las carpetas en el nivel superior de la estructura de carpetas, en el archivo o el buzón de destino. El contenido se fusiona en las carpetas existentes y se crean carpetas nuevas si no existen ya en la estructura de carpetas de destino.

Este parámetro solo está disponible en los buzones principales y se omite en los buzones de archivo. Si no existe, se crea una carpeta de destino. Las rutas válidas son:

  • /
  • /folder1
  • /folder1/folder2
  • folder1
  • folder1/folder2

Se ignoran / los créditos anteriores o finales. A continuación, se trata como la ruta de acceso relativa del subárbol de IPM: /Top Of Information Store.

Propiedades de parámetro

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

Conjuntos de parámetros

Default
Posición:Named
Mandatory: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
Mandatory: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 de Elementos eliminados.
  • RecoverableItems: la carpeta Recoverable Items\Deletions. Esta carpeta contiene los elementos que se han eliminado de la carpeta Elementos eliminados (elementos de eliminación temporal).
  • PurgedItems: carpeta Elementos recuperables\Purgas. Esta carpeta contiene los elementos que se han purgado de la carpeta Elementos recuperables (elementos eliminados permanentemente).

Si no usa este parámetro, el comando busca esas tres carpetas.

  • DiscoveryHoldsItems (solo nube): la carpeta Recoverable Items\DiscoveryHolds. Esta carpeta contiene los elementos que se han purgado de la carpeta Elementos recuperables (elementos eliminados permanentemente) y que 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

OnPrem
Posición:Named
Mandatory: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 eliminados por el valor de texto especificado en el campo Subject. 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
Mandatory: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.