Restore-Mailbox

Referencia

Módulo:: ExchangePowerShell

Se aplica a:: Exchange Server 2010

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.