New-MailboxRestoreRequest
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.
Utilice el cmdlet New-MailboxRestoreRequest para restaurar un buzón desconectado o eliminado temporalmente. Este cmdlet inicia el proceso de mover el contenido del buzón eliminado temporalmente, deshabilitado o cualquier buzón de una base de datos de recuperación, a un buzón de archivo o principal conectado.
Las propiedades usadas para buscar buzones desconectados y restaurar un buzón son diferentes en Exchange Server y Exchange Online. Para obtener más información sobre Exchange Online, consulte Restauración de un buzón inactivo.
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
New-MailboxRestoreRequest
-SourceDatabase <DatabaseIdParameter>
-SourceStoreMailbox <StoreMailboxIdParameter>
-TargetMailbox <MailboxOrMailUserIdParameter>
[-AcceptLargeDataLoss]
[-AllowLegacyDNMismatch]
[-AssociatedMessagesCopyOption <FAICopyOption>]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-Confirm]
[-ConflictResolutionOption <ConflictResolutionOption>]
[-DomainController <Fqdn>]
[-ExcludeDumpster]
[-ExcludeFolders <String[]>]
[-IncludeFolders <String[]>]
[-MRSServer <Fqdn>]
[-Name <String>]
[-Priority <RequestPriority>]
[-SourceRootFolder <String>]
[-SuspendComment <String>]
[-Suspend]
[-TargetIsArchive]
[-TargetRootFolder <String>]
[-WhatIf]
[<CommonParameters>] New-MailboxRestoreRequest
-SourceEndpoint <MigrationEndpointIdParameter>
-SourceExchangeGuid <Guid>
-SourceTenant <SmtpDomain>
-TargetMailbox <MailboxLocationIdParameter>
[-AcceptLargeDataLoss]
[-AllowLegacyDNMismatch]
[-AssociatedMessagesCopyOption <FAICopyOption>]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-ConflictResolutionOption <ConflictResolutionOption>]
[-ContentFilter <String>]
[-ContentFilterLanguage <CultureInfo>]
[-CrossTenantRestore]
[-DomainController <Fqdn>]
[-ExcludeDumpster]
[-ExcludeFolders <String[]>]
[-IncludeFolders <String[]>]
[-LargeItemLimit <Unlimited>]
[-Name <String>]
[-SkipMerging <SkippableMergeComponent[]>]
[-SourceRootFolder <String>]
[-SuspendComment <String>]
[-Suspend]
[-TargetIsArchive]
[-TargetRootFolder <String>]
[-TargetType <TargetTypeComponent>]
[-WhatIf]
[<CommonParameters>] New-MailboxRestoreRequest
-SourceDatabase <DatabaseIdParameter>
-SourceStoreMailbox <StoreMailboxIdParameter>>
[-AcceptLargeDataLoss]
[-AllowLegacyDNMismatch]
[-AssociatedMessagesCopyOption <FAICopyOption>]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-ConflictResolutionOption <ConflictResolutionOption>]
[-ContentFilter <String>]
[-ContentFilterLanguage <CultureInfo>]
[-DomainController <Fqdn>]
[-ExcludeDumpster]
[-ExcludeFolders <String[]>]
[-IncludeFolders <String[]>]
[-InternalFlags <InternalMrsFlag[]>]
[-LargeItemLimit <Unlimited>]
[-Name <String>]
[-Priority <RequestPriority>]
[-RequestExpiryInterval <Unlimited>]
[-SkipMerging <SkippableMergeComponent[]>]
[-SourceRootFolder <String>]
[-Suspend]
[-SuspendComment <String>]
[-TargetIsArchive]
[-TargetRootFolder <String>]
[-TargetType <TargetTypeComponent>]
[-WhatIf]
[-WorkloadType <RequestWorkloadType>]
[<CommonParameters>] New-MailboxRestoreRequest
-SourceStoreMailbox <StoreMailboxIdParameter>
-TargetMailbox <MailboxLocationIdParameter>
[-AcceptLargeDataLoss]
[-AllowLegacyDNMismatch]
[-AssociatedMessagesCopyOption <FAICopyOption>]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-ConflictResolutionOption <ConflictResolutionOption>]
[-ContentFilter <String>]
[-ContentFilterLanguage <CultureInfo>]
[-DomainController <Fqdn>]
[-ExcludeDumpster]
[-ExcludeFolders <String[]>]
[-IncludeFolders <String[]>]
[-InternalFlags <InternalMrsFlag[]>]
[-LargeItemLimit <Unlimited>]
[-Name <String>]
[-Priority <RequestPriority>]
[-RequestExpiryInterval <Unlimited>]
[-SkipMerging <SkippableMergeComponent[]>]
[-SourceRootFolder <String>]
[-Suspend]
[-SuspendComment <String>]
[-TargetIsArchive]
[-TargetRootFolder <String>]
[-TargetType <TargetTypeComponent>]
[-WhatIf]
[-WorkloadType <RequestWorkloadType>]
[<CommonParameters>] New-MailboxRestoreRequest
-SourceStoreMailbox <StoreMailboxIdParameter>
-TargetMailbox <MailboxOrMailUserIdParameter>
[-AcceptLargeDataLoss]
[-AllowLegacyDNMismatch]
[-AssociatedMessagesCopyOption <FAICopyOption>]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-ConflictResolutionOption <ConflictResolutionOption>]
[-DomainController <Fqdn>]
[-ExcludeDumpster]
[-ExcludeFolders <String[]>]
[-IncludeFolders <String[]>]
[-InternalFlags <InternalMrsFlag[]>]
[-LargeItemLimit <Unlimited>]
[-Name <String>]
[-Priority <RequestPriority>]
[-SkipMerging <SkippableMergeComponent[]>]
[-SourceRootFolder <String>]
[-Suspend]
[-SuspendComment <String>]
[-TargetIsArchive]
[-TargetRootFolder <String>]
[-WhatIf]
[-WorkloadType <RequestWorkloadType>]
[<CommonParameters>] New-MailboxRestoreRequest
-RemoteDatabaseGuid <Guid>
-RemoteHostName <Fqdn>
-RemoteRestoreType <RemoteRestoreType>
-RemoteCredential <PSCredential>
-SourceMailbox <MailboxLocationIdParameter>
-TargetMailbox <MailboxLocationIdParameter>
[-AcceptLargeDataLoss]
[-AllowLegacyDNMismatch]
[-AssociatedMessagesCopyOption <FAICopyOption>]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-ConflictResolutionOption <ConflictResolutionOption>]
[-ContentFilter <String>]
[-ContentFilterLanguage <CultureInfo>]
[-DomainController <Fqdn>]
[-ExcludeDumpster]
[-ExcludeFolders <String[]>]
[-IncludeFolders <String[]>]
[-InternalFlags <InternalMrsFlag[]>]
[-LargeItemLimit <Unlimited>]
[-Name <String>]
[-Priority <RequestPriority>]
[-RequestExpiryInterval <Unlimited>]
[-SkipMerging <SkippableMergeComponent[]>]
[-SourceIsArchive]
[-SourceRootFolder <String>]
[-Suspend]
[-SuspendComment <String>]
[-TargetIsArchive]
[-TargetRootFolder <String>]
[-TargetType <TargetTypeComponent>]
[-WhatIf]
[-WorkloadType <RequestWorkloadType>]
[<CommonParameters>] Description
Cuando los buzones se mueven de una base de datos a otra, Exchange no elimina por completo el buzón de la base de datos de origen inmediatamente después de completar el traslado. En lugar de hacer eso, el buzón de la base de datos de buzones de origen cambia a un estado de eliminación temporal que permite el acceso a los datos del buzón durante una operación de restauración mediante el nuevo conjunto de cmdlet MailboxRestoreRequest. Los buzones eliminados temporalmente se conservan en la base de datos de origen hasta que vence el período de retención o hasta que se utiliza el cmdlet Remove-StoreMailbox para purgar el buzón.
Para ver los buzones eliminados temporalmente, ejecute el cmdlet Get-MailboxStatistics en una base de datos y fíjese en los resultados en que DisconnectReason tiene el valor SoftDeleted. Para obtener más información, consulte el Ejemplo 1 que encontrará más adelante en este tema.
Un buzón se marca como deshabilitado poco después de que los comandos Disable-Mailbox o Remove-Mailbox terminen.
El buzón no se marcará como Deshabilitado hasta que el servicio Microsoft Exchange Information Store determine que Active Directory se ha actualizado con la información del buzón deshabilitado. Puede acelerar el proceso ejecutando el cmdlet Update-StoreMailboxState en esa base de datos.
Exchange conserva los buzones deshabilitados en la base de datos de buzones en función de la configuración de retención de buzones eliminada configurada para esa base de datos de buzones. Tras el período de tiempo especificado, se elimina permanentemente del buzón.
Para ver los buzones deshabilitados, ejecute el cmdlet Get-MailboxStatistics en una base de datos y fíjese en los resultados en que DisconnectReason tiene el valor Disabled. Para obtener más información, vea los ejemplos 2 y 3 más adelante en este tema.
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.
Nota: Para restaurar el contenido de un buzón principal a un buzón de archivo, use el parámetro TargetRootFolder para especificar las carpetas de buzón de archivo a las que migrar el contenido. Este contenido será visible después de restaurarlo. Si no usa este parámetro, el contenido restaurado no es visible porque está asignado a ubicaciones del buzón de archivo que no son visibles para los usuarios.
Ejemplos
Ejemplo 1
Get-MailboxStatistics -Database MBD01 | Where {$_.DisconnectReason -eq "SoftDeleted" -or $_.DisconnectReason -eq "Disabled"} | Format-List LegacyExchangeDN,DisplayName,MailboxGUID, DisconnectReason
New-MailboxRestoreRequest -SourceDatabase "MBD01" -SourceStoreMailbox 1d20855f-fd54-4681-98e6-e249f7326ddd -TargetMailbox AylaEn Exchange local, en este ejemplo se usa el cmdlet Get-MailboxStatistics para devolver los valores DisplayName, LegacyExchangeDN y MailboxGUID (valores de identidad de buzón de correo de origen válidos) para todos los buzones de la base de datos de buzones denominados MBD01 que tienen un motivo de desconexión de SoftDeleted o Disabled.
Con esta información, el buzón de origen con el valor MailboxGUID 1d20855f-fd54-4681-98e6-e249f7326dddd se restaura en el buzón de destino que tiene el valor alias Ayla.
Ejemplo 2
New-MailboxRestoreRequest -SourceDatabase "MBD01" -SourceStoreMailbox "Tony Smith" -TargetMailbox Tony@contoso.com -TargetIsArchiveEn Exchange local, en este ejemplo se restaura el contenido del buzón de origen con el displayname de Tony Smith en la base de datos de buzón MBD01 en el buzón de archivo para Tony@contoso.com.
Parámetros
-AcceptLargeDataLoss
El modificador AcceptLargeDataLoss especifica que la solicitud debe continuar aunque no se pueda copiar un gran número de elementos del buzón de origen al buzón de destino. No es necesario especificar un valor con este modificador.
En Exchange 2013 o posterior, o en Exchange Online, necesita usar este modificador si establece el parámetro LargeItemLimit en un valor de 51 o más. De lo contrario, se producirá un error en el comando.
En Exchange 2010, debe usar este modificador si establece el parámetro BadItemLimit en un valor de 51 o más. De lo contrario, se producirá un error en el comando.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-AllowLegacyDNMismatch
El modificador AllowLegacyDNMismatch especifica que la operación debe continuar si el LegacyExchangeDN del buzón físico de origen y el buzón de destino no coinciden. No es necesario especificar un valor con este modificador.
De forma predeterminada, este cmdlet comprueba que el valor de LegacyExchangeDN en el buzón físico de origen esté presente en el usuario de destino en forma de LegacyExchangeDN o de dirección de proxy X500 correspondiente a LegacyExchangeDN. Esta comprobación evita que se restaure un buzón de origen en el buzón de destino incorrecto por accidente.
Nota: Este parámetro está obsoleto en el servicio basado en la nube. Para completar una solicitud de restauración de buzones de correo con un LegacyExchangeDN que no coincida, debe obtener el valor LegacyExchangeDN para el buzón de origen y agregarlo al buzón de destino como una dirección de proxy X500. Para obtener instrucciones detalladas, consulte Restauración de un buzón inactivo.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-AssociatedMessagesCopyOption
El parámetro AssociatedMessagesCopyOption especifica si los mensajes asociados se copian cuando se procesa la solicitud. Los mensajes asociados son mensajes especiales que contienen datos ocultos con información sobre reglas, vistas y formularios. Los valores admitidos son:
- DoNotCopy: los mensajes asociados no se copian.
- MapByMessageClass: busque el mensaje asociado buscando el atributo MessageClass del mensaje de origen. Si hay un mensaje asociado de esta clase en carpetas de origen y de destino, sobrescribe el mensaje asociado en el destino. Si no hay un mensaje asociado en el destino, crea una copia en el destino.
- Copiar: copie los mensajes asociados del origen al destino. Si el mismo tipo de mensaje existe tanto en el origen como en la ubicación de destino, estos mensajes asociados se duplican. Este es el valor predeterminado.
Copy: esta opción copia los mensajes asociados del origen al destino. Si existe el mismo tipo de mensaje en la ubicación de origen y de destino, estos mensajes asociados se duplican. Es la opción predeterminada.
| Type: | FAICopyOption |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-BadItemLimit
El parámetro BadItemLimit especifica el número máximo de elementos incorrectos que se permiten antes de que se produzca un error en la solicitud. Un elemento incorrecto es un elemento dañado en el buzón de origen no se puede copiar en el buzón de destino. También se incluyen los elementos que faltan en el límite de elementos incorrectos. Los elementos que faltan son elementos del buzón de origen que no se encuentran en el buzón de destino cuando la solicitud está lista para completarse.
La entrada válida para este parámetro es un número entero o el valor Unlimited. El valor predeterminado es 0, lo que significa que se producirá un error si se detectan elementos incorrectos. Si le parece bien dejar rezagados algunos elementos incorrectos, puede establecer este parámetro en un valor razonable (se recomienda 10 o menos) para que la solicitud pueda continuar. Si se detectan demasiados elementos incorrectos, considere la posibilidad de usar el cmdlet New-MailboxRepairRequest para intentar corregir los elementos dañados en el buzón de origen y volver a intentar la solicitud.
En Exchange 2010, si establece este valor en 51 o más, también deberá utilizar el modificador AcceptLargeDataLoss. De lo contrario, se producirá un error en el comando.
Nota: Este parámetro está obsoleto en el servicio basado en la nube. En el futuro, si no usa este parámetro, se usará la semántica de aprobación de Skipped Item en su lugar.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-BatchName
El parámetro BatchName especifica un nombre descriptivo para restaurar un lote de buzones. Puede usar el nombre incluido en el parámetro BatchName como cadena de búsqueda cuando use el cmdlet Get-MailboxRestoreRequest.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-CompletedRequestAgeLimit
El parámetro CompletedRequestAgeLimit especifica durante cuánto tiempo el estado de una restauración completada estará establecido como Completed. Si este parámetro se configura con el valor 0, el estado se borra inmediatamente en lugar de cambiar a Completed.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-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, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ConflictResolutionOption
El parámetro ConflictResolutionOption especifica qué hacer si hay varios mensajes coincidentes en el destino. Los valores admitidos son:
- ForceCopy
- KeepAll
- KeepLatestItem
- KeepLatestItem
- KeepTargetItem
- UpdateFromSource
| Type: | ConflictResolutionOption |
| Position: | Named |
| Default value: | KeepSourceItem |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ContentFilter
Este parámetro solo está disponible en el servicio basado en la nube.
El parámetro ContentFilter usa la sintaxis de filtro de OPATH para filtrar los resultados por las propiedades y valores especificados. Solo se restaurará el contenido que coincida con el parámetro ContentFilter. Los criterios de búsqueda usan la sintaxis "Property -ComparisonOperator 'Value'".
- Incluya todo el filtro de OPATH entre comillas dobles " ". Si el filtro contiene valores del sistema (por ejemplo, ,
$true$falseo$null), use comillas simples ' ' en su lugar. Aunque este parámetro es una cadena (no un bloque del sistema), también puede usar llaves { }, pero solo si el filtro no contiene variables. - La propiedad es una propiedad filtrable. Para ver las propiedades filtrables, vea Propiedades filtrables para el parámetro ContentFilter.
- ComparisonOperator es un operador de comparación de OPATH (por ejemplo
-eq, para igual y-likepara la comparación de cadenas). Para obtener más información sobre los operadores de comparación, consulte about_Comparison_Operators. - Value es el valor de propiedad que se va a buscar. Incluya valores de texto y variables entre comillas simples (
'Value'o'$Variable'). Si un valor de variable contiene comillas simples, debe identificar (escape) las comillas simples para expandir la variable correctamente. Por ejemplo, en lugar de'$User', use'$($User -Replace "'","''")'. No incluya enteros ni valores del sistema entre comillas (por ejemplo, use500,$true,$falseo$nullen su lugar).
Puede encadenar varios criterios de búsqueda mediante los operadores lógicos -and y -or. Por ejemplo, "Criteria1 -and Criteria2" o "(Criteria1 -and Criteria2) -or Criteria3".
Para obtener información detallada sobre los filtros de OPATH en Exchange, consulte Información adicional de la sintaxis de OPATH.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ContentFilterLanguage
Este parámetro solo está disponible en el servicio basado en la nube.
El parámetro ContentFilterLanguage especifica el idioma que se usa en el parámetro ContentFilter para las cadenas de búsqueda.
La entrada válida para este parámetro es un valor de código de referencia cultural compatible de la clase CultureInfo de Microsoft .NET Framework. Por ejemplo, da-DK para danés o ja-JP para japonés. Para obtener más información, vea CultureInfo (clase).
| Type: | CultureInfo |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-CrossTenantRestore
Este parámetro solo está disponible en el servicio basado en la nube.
Este parámetro está reservado para uso interno de Microsoft.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-DomainController
Este parámetro solo funciona en Exchange local.
El parámetro DomainController especifica el controlador de dominio que el cmdlet usa para leer datos de Active Directory o escribirlos. El controlador de dominio se identifica por su nombre de dominio completo (FQDN). Por ejemplo, dc01.contoso.com.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ExcludeDumpster
El modificador ExcludeDumpster especifica si se debe excluir la carpeta Elementos recuperables. No es necesario especificar un valor con este modificador.
Si no usa este modificador, la carpeta Elementos recuperables se copia con las siguientes subcarpetas:
- Eliminaciones
- Versiones
- Purgas
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ExcludeFolders
El parámetro ExcludeFolders especifica la lista de carpetas que se excluirán durante la solicitud de restauración.
Debe establecer el parámetro ImmutableId si los Servicios de federación de exADNoMk (AD FS) se implementan para permitir el inicio de sesión único en un buzón no local y los AD FS se configuran para usar un atributo diferente a ExchangeGUID para las solicitudes de token de inicio de sesión. Tanto exExchangeNoVersion como los AD FS deben solicitar el mismo token para el mismo usuario y así asegurar que funcionen correctamente en un escenario de implementación entre locales de exExchangeNoVersion.
<FolderName>/*: use esta sintaxis para indicar una carpeta personal en la carpeta especificada en el parámetro SourceRootFolder, por ejemplo, "MyProjects" o "MyProjects/FY2010".
#<FolderName>#/*: use esta sintaxis para indicar una carpeta conocida independientemente del nombre de la carpeta en otro idioma. Por ejemplo, #Bandeja de entrada# indica la carpeta Bandeja de entrada incluso si la Bandeja de entrada está localizada en turco, que es Gelen Kutusu. Las carpetas conocidas incluyen los siguientes tipos:
- Bandeja de entrada
- SentItems
- DeletedItems
- Calendario
- Contactos
- Borradores
- Diario
- Tareas
- Notas
- Correo basura
- CommunicatorHistory
- Correo de voz
- Fax
- Conflictos
- SyncIssues
- LocalFailures
- ServerFailures
Si el usuario crea una carpeta personal con el mismo nombre que una carpeta conocida y el símbolo # que la rodea, puede usar una barra diagonal inversa (\) como carácter de escape para especificar esa carpeta. Por ejemplo, si un usuario crea una carpeta denominada #Notes# y desea especificar esa carpeta en lugar de la carpeta Notes conocida, use la sintaxis siguiente: \#Notes\#.
Si el usuario crea una carpeta personal con el mismo nombre que una carpeta conocida y el símbolo # en torno a ella, puede usar una barra diagonal inversa (\) como carácter de escape para especificar esa carpeta. Por ejemplo, si un usuario crea una carpeta llamada #Notes# y desea especificar esa carpeta, pero no la carpeta conocida Notas conocida, use la siguiente sintaxis: \#Notes\#.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-IncludeFolders
El parámetro IncludeFolders especifica la lista de carpetas que se incluirán durante la solicitud de restauración.
Debe establecer el parámetro ImmutableId si los Servicios de federación de exADNoMk (AD FS) se implementan para permitir el inicio de sesión único en un buzón no local y los AD FS se configuran para usar un atributo diferente a ExchangeGUID para las solicitudes de token de inicio de sesión. Tanto exExchangeNoVersion como los AD FS deben solicitar el mismo token para el mismo usuario y así asegurar que funcionen correctamente en un escenario de implementación entre locales de exExchangeNoVersion.
<FolderName>/*: use esta sintaxis para indicar una carpeta personal en la carpeta especificada en el parámetro SourceRootFolder, por ejemplo, "MyProjects" o "MyProjects/FY2010".
#<FolderName>#/*: use esta sintaxis para indicar una carpeta conocida independientemente del nombre de la carpeta en otro idioma. Por ejemplo, #Bandeja de entrada# indica la carpeta Bandeja de entrada incluso si la Bandeja de entrada está localizada en turco, que es Gelen Kutusu. Las carpetas conocidas incluyen los siguientes tipos:
- Bandeja de entrada
- SentItems
- DeletedItems
- Calendario
- Contactos
- Borradores
- Diario
- Tareas
- Notas
- Correo basura
- CommunicationHistory
- Correo de voz
- Fax
- Conflictos
- SyncIssues
- LocalFailures
- ServerFailures
Si el usuario crea una carpeta personal con el mismo nombre que una carpeta conocida y el símbolo # que la rodea, puede usar una barra diagonal inversa (\) como carácter de escape para especificar esa carpeta. Por ejemplo, si un usuario crea una carpeta denominada #Notes# y desea especificar esa carpeta en lugar de la carpeta Notes conocida, use la sintaxis siguiente: \#Notes\#.
Si el usuario crea una carpeta personal con el mismo nombre que una carpeta conocida y el símbolo # en torno a ella, puede usar una barra diagonal inversa (\) como carácter de escape para especificar esa carpeta. Por ejemplo, si un usuario crea una carpeta llamada #Notes# y desea especificar esa carpeta, pero no la carpeta conocida Notas conocida, use la siguiente sintaxis: \#Notes\#.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-InternalFlags
Este parámetro solo está disponible en Exchange local.
El parámetro InternalFlags especifica los pasos opcionales de la solicitud. Este parámetro se usa principalmente con fines de depuración.
| Type: | InternalMrsFlag[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-LargeItemLimit
El parámetro LargeItemLimit especifica la cantidad máxima de elementos grandes que se permiten antes de que se produzca un error en la solicitud. Un elemento grande es un mensaje en el buzón de origen que supera el tamaño máximo de mensaje permitido en el buzón de destino. Si el buzón de destino no tiene un valor de tamaño máximo de mensaje configurado específicamente, se usa el valor configurado para toda la organización.
Para obtener más información sobre los valores de tamaño máximo de los mensajes, consulte los siguientes temas:
- Exchange 2016: límites de tamaño de mensaje en Exchange Server
- Exchange Online: Límites de Exchange Online
La entrada válida para este parámetro es un número entero o el valor Unlimited. El valor predeterminado es 0, lo que significa que la solicitud producirá un error si se detectan elementos grandes. Si le parece bien dejar rezagados algunos elementos grandes, puede establecer este parámetro en un valor razonable (se recomienda 10 o menos) para que la solicitud pueda continuar.
Si establece este valor en 51 o más, también deberá utilizar el modificador AcceptLargeDataLoss. De lo contrario, se producirá un error en el comando.
Nota: Este parámetro está obsoleto en el servicio basado en la nube. En el futuro, si no usa este parámetro, se usará la semántica de aprobación de Skipped Item en su lugar.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-MRSServer
Este parámetro solo está disponible en Exchange Server 2010.
El parámetro MRSServer especifica el FQDN del servidor de acceso de cliente en el que se ejecuta la instancia del Servicio de replicación de buzones (MRS) de Microsoft Exchange. Este parámetro se usa con fines de depuración solamente. Use este parámetro únicamente si lo indica el personal de soporte técnico.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-Name
El parámetro Name especifica el nombre de la solicitud específica para mostrarlo y realizar el seguimiento. Dado que puede tener varias solicitudes de restauración por buzón, Exchange precede al nombre con el alias del buzón. Por ejemplo, si crea una solicitud de exportación para el buzón de un usuario que tiene el alias Kweku y especifica el valor de este parámetro como RestoreFailedMoves, la identidad de esta solicitud de exportación será Kweku\RestoreFailedMoves.
Si no especificó un nombre para la solicitud de restauración cuando se creó, Exchange genera automáticamente el nombre predeterminado MailboxRestore. Exchange genera hasta 10 nombres, empezando por MailboxRestore y, a continuación, MailboxRestoreX (donde X = 1-9).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Priority
Este parámetro solo está disponible en Exchange local.
El parámetro Priority especifica el orden en el que se debe procesar esta solicitud en la cola de solicitudes. Las solicitudes se procesan en orden, según el mantenimiento, el estado, la prioridad y la hora de la última actualización. Los valores de prioridad válidos son:
- Lowest
- Lower
- Low
- Normal (este es el valor predeterminado).
- High
- Higher
- Highest
- Emergency
| Type: | RequestPriority |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-RemoteCredential
Este parámetro solo está disponible en el servicio basado en la nube.
Este parámetro está reservado para uso interno de Microsoft.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-RemoteDatabaseGuid
Este parámetro solo está disponible en el servicio basado en la nube.
Este parámetro está reservado para uso interno de Microsoft.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-RemoteHostName
Este parámetro solo está disponible en el servicio basado en la nube.
Este parámetro está reservado para uso interno de Microsoft.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-RemoteRestoreType
Este parámetro solo está disponible en el servicio basado en la nube.
Este parámetro está reservado para uso interno de Microsoft.
| Type: | RemoteRestoreType |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-RequestExpiryInterval
Este parámetro solo está disponible en Exchange local.
El parámetro RequestExpiryInterval especifica un límite de edad para una solicitud completada o fallida. Cuando se usa este parámetro, la solicitud completada o fallida se elimina automáticamente después de que caduque el intervalo especificado. Si no usa este parámetro:
- La solicitud completada se quita automáticamente en función del valor del parámetro CompletedRequestAgeLimit.
- Si se produce un error en la solicitud, debe quitarla manualmente mediante el cmdlet Remove-*Request correspondiente.
Para especificar un valor, escríbalo como un intervalo de tiempo: dd.hh:mm:ss donde dd = días, hh = horas, mm = minutos y ss = segundos.
Cuando se usa el valor Unlimited, la solicitud completada no se quita automáticamente.
| 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 |
-SkipMerging
El parámetro SkipMerging especifica los elementos relacionados con las carpetas que se deben omitir al restaurar el buzón. Use uno de los siguientes valores:
- FolderACLs
- FolderProperties
- FolderRules
- InitialConnectionValidation
Use este parámetro solamente si se produce un error en una solicitud de restauración debido a reglas de carpeta, a listas de control de acceso (ACL) de carpeta o a la validación de conexión inicial.
| Type: | SkippableMergeComponent[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SourceDatabase
Este parámetro solo está disponible en Exchange local.
El parámetro SourceDatabase especifica la identidad de la base de datos desde la que se restaura el buzón desconectado o eliminado temporalmente. 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, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-SourceEndpoint
Este parámetro solo está disponible en el servicio basado en la nube.
Este parámetro está reservado para uso interno de Microsoft.
| Type: | MigrationEndpointIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-SourceExchangeGuid
Este parámetro solo está disponible en el servicio basado en la nube.
Este parámetro está reservado para uso interno de Microsoft.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-SourceIsArchive
El modificador SourceIsArchive especifica que el buzón de origen es un buzón de archivo. No es necesario especificar un valor con este modificador.
Solo puede usar este modificador con el parámetro SourceMailbox.
| Type: | SwitchParameter |
| 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 |
-SourceMailbox
El parámetro SourceMailbox especifica el buzón eliminado temporalmente que desea restaurar. La mejor manera de identificar el buzón eliminado temporalmente es por su valor GUID. Puede obtener este valor mediante la ejecución del comando siguiente: Get-Mailbox -SoftDeletedMailbox.
| Type: | SourceMailbox |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SourceRootFolder
El parámetro SourceRootFolder especifica la carpeta raíz del buzón desde la que se restaurarán los datos. Si no se especifica este parámetro, el comando restaurará todas las carpetas.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SourceStoreMailbox
Este parámetro solo funciona en Exchange local.
El parámetro SourceStoreMailbox especifica el mailboxGUID del buzón de origen desde el que desea restaurar el contenido.
Puede encontrar MailboxGUID ejecutando el cmdlet Get-MailboxStatistics.
| Type: | StoreMailboxIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SourceTenant
Este parámetro solo está disponible en el servicio basado en la nube.
Este parámetro está reservado para uso interno de Microsoft.
| Type: | SmtpDomain |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Suspend
El modificador Suspend especifica si se suspenderá la solicitud. No es necesario especificar un valor con este modificador.
Si usa este modificador, la solicitud se pone en la cola, pero no alcanza el estado de InProgress hasta que la reanude con el cmdlet de reanudación adecuado.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SuspendComment
El parámetro SuspendComment especifica una descripción del motivo por el cual se suspendió la solicitud. Solo puede usar este parámetro si especifica el parámetro Suspend.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-TargetIsArchive
El modificador TargetIsArchive especifica que el contenido se restaura en el archivo del buzón de destino especificado. 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 Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-TargetMailbox
El parámetro TargetMailbox especifica el GUID del buzón de destino o el usuario de correo en el que desea restaurar el contenido. El buzón de destino o el usuario de correo deben existir para que este comando se ejecute correctamente.
Puede encontrar el valor GUID para el buzón de correo o el usuario de correo mediante la ejecución de los cmdlets Get-Mailbox o Get-MailUser.
En Exchange 2016 o posterior y Exchange Online, este parámetro es el tipo MailboxLocationIdParameter.
En Exchange 2013 o versiones anteriores, este parámetro es el tipo MailboxOrMailUserIdParameter.
| Type: | MailboxLocationIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-TargetRootFolder
El parámetro TargetRootFolder especifica la carpeta de nivel superior en la que se deben 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.
Nota: Para restaurar el contenido de un buzón principal a un buzón de archivo, use este parámetro para especificar las carpetas de buzón de archivo a las que migrar el contenido. Este contenido será visible después de restaurarlo. Si no usa este parámetro, el contenido restaurado no es visible porque está asignado a ubicaciones del buzón de archivo que no son visibles para los usuarios.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-TargetType
El parámetro TargetType especifica el tipo de buzón de correo que es el destino de la operación de restauración. Los valores admitidos son:
- Archivar
- MailboxLocation
- Principal (este es el valor predeterminado)
| Type: | TargetTypeComponent |
| 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 |
-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, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-WorkloadType
Este parámetro solo está disponible en Exchange local.
Este parámetro está reservado para uso interno de Microsoft.
| Type: | RequestWorkloadType |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
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.