Restore-Mailbox
Este cmdlet solo está disponible en Exchange Server 2010.
Use el cmdlet Restore-Mailbox para extraer contenido de buzón de una base de datos restaurada.
Nota: En Exchange Server 2010 Service Pack 1 (SP1) o posterior, use el cmdlet New-MailboxRestoreRequest en lugar del cmdlet Restore-Mailbox para extraer contenido de buzón de una base de datos restaurada.
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-Mailbox
[-Identity] <MailboxIdParameter>
-RecoveryDatabase <DatabaseIdParameter>
-RecoveryMailbox <StoreMailboxIdParameter>
-TargetFolder <String>
[-AllowDuplicates]
[-AllContentKeywords <String[]>]
[-AttachmentFilenames <String[]>]
[-BadItemLimit <Int32>]
[-Confirm]
[-ContentKeywords <String[]>]
[-EndDate <DateTime>]
[-ExcludeFolders <MapiFolderPath[]>]
[-GlobalCatalog <Fqdn>]
[-IncludeFolders <MapiFolderPath[]>]
[-Locale <CultureInfo>]
[-MaxThreads <Int32>]
[-RecipientKeywords <String[]>]
[-SenderKeywords <String[]>]
[-StartDate <DateTime>]
[-SubjectKeywords <String[]>]
[-ValidateOnly]
[-WhatIf]
[<CommonParameters>]
Description
El cmdlet Restore-Mailbox copia los datos del usuario final de cualquier servidor que ejecute Microsoft Exchange Server 2010 en un buzón de correo de un servidor de buzones de Exchange 2010 de la misma organización que tenga espacio y recursos adecuados para admitir el buzón. El cmdlet Restore-Mailbox solo puede usar buzones desconectados en un servidor como origen de datos y el cmdlet solo puede usar buzones conectados como destino para los datos.
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-Mailbox -Identity Scott -RecoveryDatabase MyRecoveryDatabase
En este ejemplo se restaura un buzón para el usuario Scott de la base de datos MyRecoveryDatabase.
Ejemplo 2
Restore-Mailbox -Identity Scott -RecoveryDatabase MyRecoveryDatabase -RecoveryMailbox John -TargetFolder Recovery
En este ejemplo se restaura el contenido del buzón de John en el buzón de Scott en la carpeta Recuperación.
Ejemplo 3
Restore-Mailbox -Identity Scott -RecoveryDatabase MyRecoveryDatabase -SubjectKeywords "Meeting" -ContentKeywords "business" -IncludeFolders \Inbox,\Calendar
En este ejemplo solo se restaura el correo con la reunión del asunto, con el cuerpo del mensaje que contiene la palabra empresa y con la ubicación del mensaje en la carpeta Bandeja de entrada o Calendario. En este ejemplo se supone que el buzón está en inglés.
Ejemplo 4
Get-Mailbox -Database MyDatabase | Restore-Mailbox -RecoveryDatabase MyRecoveryDatabase
En este ejemplo se restauran de forma masiva todos los buzones de la base de datos de buzones de MyDatabase que también están presentes en MyRecoveryDatabase.
Parámetros
-AllContentKeywords
El parámetro AllContentKeywords especifica los filtros para todos los siguientes elementos:
- Subject
- Cuerpo del mensaje
- Contenido de datos adjuntos
Esto permite una búsqueda OR de todos estos campos. Si los criterios de búsqueda forman parte del asunto, el cuerpo del mensaje o el contenido de los datos adjuntos, obtendrá resultados.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-AllowDuplicates
El modificador AllowDuplicates copia los elementos de correo sin comprobar si son duplicados de elementos existentes y sin quitar elementos duplicados. No es necesario especificar un valor con este modificador.
Se recomienda usar este modificador con el parámetro IncludeFolders.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-AttachmentFilenames
El parámetro AttachmentFilenames especifica el filtro para el nombre del archivo de datos adjuntos. Puede usar caracteres comodín en la cadena. Por ejemplo, puede usar *.txt para exportar elementos que tengan una extensión de .txt.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-BadItemLimit
El parámetro BadItemLimit especifica el número de elementos dañados en un buzón que se omitirán antes de que se produzca un error en la operación de exportación.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-Confirm
El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador el cmdlet depende de si el cmdlet requiere confirmación antes de continuar.
- Los cmdlets destructivos (por ejemplo, cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta:
-Confirm:$false
. - La mayoría de los demás cmdlets (por ejemplo, los cmdlets New-* y Set-*) no tienen una pausa integrada. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar el comando antes de continuar.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-ContentKeywords
El parámetro ContentKeywords especifica los filtros de palabra clave para el cuerpo del mensaje y el contenido de los datos adjuntos en el buzón de origen.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-EndDate
El parámetro EndDate especifica la fecha de finalización para filtrar el contenido que se exportará desde el buzón de origen. Solo se exportan los elementos del buzón cuya fecha es anterior a la fecha de finalización. Cuando escriba una fecha específica, use el formato de fecha corta definido en la configuración de Opciones regionales configurada en el equipo local. Por ejemplo, si el equipo está configurado para usar el formato de fecha corta mm/dd/aaaa, escriba 03/01/2010 para especificar el 1 de marzo de 2010.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-ExcludeFolders
El parámetro ExcludeFolders especifica la lista de carpetas que se excluirán durante la exportación. Las carpetas se excluyen a medida que se escriben. No están localizados. Por ejemplo, excluir calendario solo excluye el calendario en inglés porque calendario en otros idiomas es una palabra diferente.
Type: | MapiFolderPath[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-GlobalCatalog
El parámetro GlobalCatalog especifica el catálogo global que se va a usar para buscar el buzón de destino.
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-Identity
El parámetro Identity especifica el buzón 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)
Type: | MailboxIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-IncludeFolders
El parámetro IncludeFolders especifica la lista de carpetas que se incluirán durante la exportación. Las carpetas se incluyen a medida que se escriben. No están localizados. Por ejemplo, incluir calendario solo incluye calendario en inglés porque calendario en otros idiomas es una palabra diferente.
Type: | MapiFolderPath[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-Locale
El parámetro Locale especifica la configuración regional de un mensaje que se va a restaurar. Con este filtro establecido, solo se extraen los mensajes con la configuración regional especificada.
Type: | CultureInfo |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-MaxThreads
El parámetro MaxThreads especifica el número máximo de subprocesos que se van a usar.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-RecipientKeywords
El parámetro RecipientKeywords especifica los filtros de palabra clave para los destinatarios de los elementos del buzón de origen. Este filtro busca la cadena de búsqueda aunque forme parte de una palabra. Esto no es una búsqueda de palabras completa.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-RecoveryDatabase
El parámetro RecoveryDatabase especifica la base de datos de recuperación desde la que se va a restaurar el buzón. Puede usar cualquier valor que identifique la base de datos de forma exclusiva. Por ejemplo:
- Nombre
- Nombre completo (DN)
- GUID
Type: | DatabaseIdParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-RecoveryMailbox
El parámetro RecoveryMailbox especifica el buzón que se va a usar como buzón de origen. Este parámetro es necesario si el buzón de origen es diferente del buzón de destino.
El buzón se identifica por su valor GUID. Puede buscar el valor GUID con los cmdlets Get-Mailbox o Get-MailboxStatistics.
Type: | StoreMailboxIdParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-SenderKeywords
El parámetro SenderKeywords especifica los filtros de palabra clave para los remitentes de elementos en el buzón de origen. Este filtro busca la cadena de búsqueda aunque forme parte de una palabra. Esto no es una búsqueda de palabras completa.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-StartDate
El parámetro StartDate especifica la fecha de inicio. La fecha de inicio debe ser anterior a la fecha de finalización.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-SubjectKeywords
El parámetro SubjectKeywords especifica los filtros de palabra clave para los asuntos de los elementos del buzón de origen. Este filtro busca la cadena de búsqueda aunque forme parte de una palabra. Esto no es una búsqueda de palabras completa.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-TargetFolder
El parámetro TargetFolder especifica la carpeta de buzón que se crea en el buzón especificado. Este parámetro es necesario si el buzón que se va a restaurar es diferente del buzón de destino. (Por ejemplo, el valor especificado con el parámetro Identity no es el mismo que el valor especificado con el parámetro RecoveryMailbox). En este caso, el comando Restore-Mailbox realiza una combinación. Si los valores son los mismos, no se requiere el parámetro TargetFolder.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-ValidateOnly
El modificador ValidateOnly indica al comando que evalúe las condiciones y los requisitos necesarios para realizar la operación y, a continuación, informe de si la operación se realizará correctamente o no. No es necesario especificar un valor con este modificador.
No se realiza ningún cambio al usar este modificador.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-WhatIf
El modificador WhatIf simula las acciones del comando. Puede usar este modificador para ver los cambios que se producirían, pero sin aplicar los cambios. No es necesario especificar un valor con este modificador.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
Entradas
Input types
Para ver los tipos de entrada que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de entrada de un cmdlet está en blanco, el cmdlet no acepta datos de entrada.
Salidas
Output types
Para ver los tipos de valor devuelto (también conocidos como tipos de resultado) que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de resultado está en blanco, el cmdlet no devuelve datos.