Set-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.
Use el cmdlet Set-MailboxRestoreRequest para cambiar las opciones de solicitud de restauración después de haber creado la solicitud. Puede usar este cmdlet para recuperar las solicitudes de restauración con error.
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
Set-MailboxRestoreRequest
[-Identity] <MailboxRestoreRequestIdParameter>
[-AcceptLargeDataLoss]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-DomainController <Fqdn>]
[-InternalFlags <InternalMrsFlag[]>]
[-LargeItemLimit <Unlimited>]
[-Priority <RequestPriority>]
[-RemoteHostName <Fqdn>]
[-RequestExpiryInterval <Unlimited>]
[-SkipInitialConnectionValidation]
[-SkipMerging <SkippableMergeComponent[]>]
[-SkippedItemApprovalTime <DateTime>]
[-SourceWlmLevel <WlmLevel>]
[-TargetWlmLevel <WlmLevel>]
[-WhatIf]
[<CommonParameters>] Set-MailboxRestoreRequest
[-Identity] <MailboxRestoreRequestIdParameter>
[-Confirm]
[-DomainController <Fqdn>]
[-RehomeRequest]
[-RemoteHostName <Fqdn>]
[-RequestExpiryInterval <Unlimited>]
[-SkipInitialConnectionValidation]
[-SkippedItemApprovalTime <DateTime>]
[-SourceWlmLevel <WlmLevel>]
[-TargetWlmLevel <WlmLevel>]
[-WhatIf]
[<CommonParameters>] Description
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
Set-MailboxRestoreRequest -Identity "Ayla\MailboxRestore1" -BadItemLimit 10En este ejemplo se cambia la segunda solicitud de restauración de Ayla\MailboxRestore1 para omitir hasta 10 elementos de buzón dañados.
Ejemplo 2
Set-MailboxRestoreRequest -Identity "Kweku\MailboxRestore" -BadItemLimit 100 -AcceptLargeDataLossEn este ejemplo se cambia la primera solicitud de restauración del buzón de Kweku para omitir hasta 100 elementos dañados. Puesto que BadItemLimit es mayor que 50, se debe especificar el parámetro AcceptLargeDataLoss.
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 |
-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 el nombre del lote. Utilice este parámetro para cambiar, crear o quitar un nombre de proceso por lotes.
Para quitar un nombre de lote, establezca el valor del parámetro BatchName en una cadena vacía o en nulo, por ejemplo, -BatchName "" o -BatchName $null.
| 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 el parámetro se establece en un valor de 0, el estado se borrará 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, Exchange Online Protection |
-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 |
-Identity
El parámetro Identity especifica la identidad de la solicitud de restauración. El parámetro Identity está formado por el alias del buzón que se debe restaurar y el nombre especificado en el momento de crear la solicitud de restauración. La identidad de la solicitud de restauración usa la sintaxis siguiente: Alias\Name
Si no especificó un nombre para la solicitud de restauración cuando se creó, Exchange generó automáticamente el nombre predeterminado MailboxRestore. Exchange genera hasta 10 nombres, empezando por MailboxRestore y, a continuación, MailboxRestoreX (donde X = 1-9).
| Type: | MailboxRestoreRequestIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-InternalFlags
Este parámetro solo funciona 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, Exchange Online |
-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 |
-Priority
Este parámetro solo funciona 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, Exchange Online |
-RehomeRequest
Este parámetro solo funciona en Exchange local.
El modificador RehomeRequest mueve la solicitud de restauración del buzón a otra base de datos de buzones. No es necesario especificar un valor con este modificador.
Use este modificador para editar una solicitud de restauración de buzón en el caso de que la base de datos de buzón de correo de origen de la solicitud de traslado original tenga que quitarse.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-RemoteHostName
Este parámetro está reservado para uso interno de Microsoft.
| Type: | Fqdn |
| 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 |
-RequestExpiryInterval
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, introdúzcalo 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, Exchange Online |
-SkipInitialConnectionValidation
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: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-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 |
-SkippedItemApprovalTime
Este parámetro solo está disponible en el servicio basado en la nube.
Este parámetro está reservado para uso interno de Microsoft.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-SourceWlmLevel
Este parámetro solo está disponible en el servicio basado en la nube.
{{ Fill SourceWlmLevel Description }}
| Type: | WlmLevel |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-TargetWlmLevel
Este parámetro solo está disponible en el servicio basado en la nube.
{{ Fill TargetWlmLevel Description }}
| Type: | WlmLevel |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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, Exchange Online Protection |
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.