Restore-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 Restore-RecoverableItems items para restaurar los elementos eliminados en los buzones de correo. Use el cmdlet Get-RecoverableItems para buscar los elementos eliminados que se van a recuperar.
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
Restore-RecoverableItems
-Identity <GeneralMailboxOrMailUserIdParameter>
[-EntryID <String>]
[-FilterEndTime <DateTime>]
[-FilterItemType <String>]
[-FilterStartTime <DateTime>]
[-LastParentFolderID <String>]
[-ResultSize <Unlimited>]
[-SourceFolder <RecoverableItemsFolderType>]
[-SubjectContains <String>]
[<CommonParameters>] 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 en 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 en la carpeta predeterminada del tipo de elemento (Bandeja de entrada para mensajes, Calendario para reuniones y citas, etc.).
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
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 de FY18
- Ubicación: Elementos recuperables\Eliminaciones
- Intervalo de fechas: 1/2/2018 al 2/5/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 denominada $mailboxes. El segundo comando restaura el mensaje especificado de 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 2En 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 de COGS FY17
- Ubicación: Elementos recuperables\Eliminaciones
- Intervalo de fechas: 15/3/2019 al 3/25/2019
- Número de buzones procesados simultáneamente: 2
Ejemplo 4
Get-RecoverableItems administrator | Restore-RecoverableItemsEn este ejemplo se restauran de forma masiva todos los elementos recuperables para el administrador.
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 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".
| 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 |
-NoOutput
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.
| Type: | SwitchParameter |
| 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 |
-RestoreTargetFolder
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 van a restaurar 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 es necesario para los archivos y opcional para los buzones principales. Si no existe, se creará una carpeta de destino. Las rutas de acceso válidas son:
//folder1/folder1/folder2folder1folder1/folder2
Se omitirá el elemento anterior o final / . A continuación, se tratará como la ruta de acceso relativa del subárbol IPM: /Top Of Information Store.
| 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 |
| Accepted values: | DeletedItems | RecoverableItems | PurgedItems |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-SubjectContains
El parámetro SubjectContains filtra los elementos eliminados 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 |