Set-MailboxImportRequest
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-MailboxImportRequest para cambiar las opciones de solicitud de importación después de haber creado dicha solicitud. Puede usar el cmdlet Set-MailboxImportRequest para recuperar solicitudes de importación con errores.
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
Set-MailboxImportRequest
[-Identity] <MailboxImportRequestIdParameter>
[-AcceptLargeDataLoss]
[-AzureSharedAccessSignatureToken <String>]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-DomainController <Fqdn>]
[-InternalFlags <InternalMrsFlag[]>]
[-LargeItemLimit <Unlimited>]
[-Priority <RequestPriority>]
[-RequestExpiryInterval <Unlimited>]
[-SkipInitialConnectionValidation]
[-SkipMerging <SkippableMergeComponent[]>]
[-SkippedItemApprovalTime <System.DateTime>]
[-WhatIf]
[<CommonParameters>] Set-MailboxImportRequest
[-Identity] <MailboxImportRequestIdParameter>
[-RehomeRequest]
[-Confirm]
[-DomainController <Fqdn>]
[-RehomeRequest]
[-RequestExpiryInterval <Unlimited>]
[-WhatIf]
[<CommonParameters>] Description
Puede canalizar el cmdlet Set-MailboxImportRequest desde el cmdletGet-MailboxImportRequest.
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-MailboxImportRequest -Identity "Kweku\Import" -BadItemLimit 5En este ejemplo se cambia la solicitud de importación Kweku\Import para que acepte hasta cinco elementos dañados de buzón.
Ejemplo 2
Get-MailboxImportRequest -Status Suspended | Set-MailboxImportRequest -BatchName April14En este ejemplo se buscan todas las solicitudes de importación que tienen el estado Suspended y se les asigna el nombre de lote April14.
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 |
-AzureSharedAccessSignatureToken
Este parámetro solo está disponible en el servicio basado en la nube.
Este parámetro está reservado para uso interno de Microsoft.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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.
| 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 la cantidad de tiempo que se conserva la solicitud una vez completada y antes de que se quite automáticamente. El valor predeterminado del parámetro CompletedRequestAgeLimit es 30 días.
| 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 |
-DomainController
Este parámetro solo está disponible 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 |
-Identity
El parámetro Identity especifica la identidad de la solicitud de importación. De forma predeterminada, las solicitudes de importación se denominan <alias>\MailboxImportX (donde X = 0-9). Si especificó un nombre para la solicitud de importación con el cmdlet New-MailboxImportRequest, use la sintaxis siguiente: Alias\Name.
| Type: | MailboxImportRequestIdParameter |
| 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 |
-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 |
-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 |
-RehomeRequest
Este parámetro solo está disponible en Exchange local.
El parámetro RehomeRequest indica al Microsoft servicio de replicación de buzones de Exchange (MRS) que la solicitud debe moverse a la misma base de datos que el buzón que se va a importar. No es necesario especificar un valor con este modificador.
Este modificador se usa principalmente con fines de depuración.
| 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 |
-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 pasos de la importación que deben omitirse. Este parámetro se usa principalmente con fines de depuración.
| 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: | System.DateTime |
| 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 |
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.