Set-MigrationUser
Este cmdlet solo funciona en el servicio basado en la nube.
Use el cmdlet Set-MigrationUser para modificar la configuración de migración de un usuario en un lote de migración existente.
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-MigrationUser
[-Identity] <MigrationUserIdParameter>
[-ApproveSkippedItems]
[-BadItemLimit <Unlimited>]
[-CompleteAfter <DateTime>]
[-Confirm]
[-DomainController <Fqdn>]
[-LargeItemLimit <Unlimited>]
[-Partition <MailboxIdParameter>]
[-StartAfter <DateTime>]
[-SyncNow]
[-WhatIf]
[<CommonParameters>] Description
Algunas opciones de configuración se pueden aplicar tanto al lote como a usuarios individuales dentro del lote. Es importante tener en cuenta que cuando se aplica una configuración a un usuario, invalidará cualquier configuración correspondiente en el lote.
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-MigrationUser -Identity laura@contoso.com -LargeItemLimit 15 -BadItemLimit 15En este ejemplo se cambia el límite de elementos grandes y el límite de elementos incorrectos para el usuario laura@contoso.com en un lote de migración existente.
Ejemplo 2
Set-MigrationUser -Identity laura@contoso.com -ApproveSkippedItemsEn este ejemplo se aprueban todos los elementos omitidos encontrados para el usuario laura@contoso.com en un lote de migración existente.
Parámetros
-ApproveSkippedItems
Este parámetro solo está disponible en el servicio basado en la nube.
El modificador ApproveSkippedItems marca todos los elementos omitidos que se detectaron antes de la hora actual como aprobados. No es necesario especificar un valor con este modificador.
Si la pérdida de datos detectada durante esta migración es significativa, la migración no podrá completarse sin aprobar los elementos omitidos. Es posible que se hayan omitido los elementos porque están dañados en el buzón de origen y no se pueden copiar en el buzón de destino, son mayores que el tamaño máximo permitido del mensaje configurado para el inquilino o se detectaron como ausentes en el buzón de destino cuando la migración está lista para completarse.
Para obtener más información sobre los valores máximos de tamaño de mensaje, vea el tema siguiente Exchange Online Límites.
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 Online |
-BadItemLimit
El parámetro BadItemLimit especifica el número máximo de elementos incorrectos permitidos antes de que se produzca un error en la solicitud de migración. 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 pueden encontrar en el buzón de destino cuando la solicitud de migración 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 en la solicitud de migración si se detecta algún elemento incorrecto. Si está de acuerdo con dejar algunos elementos incorrectos atrás, puede establecer este parámetro en un valor razonable (se recomienda 10 o inferior) para que la solicitud de migración 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 de migración.
Nota: Este parámetro está en desuso. 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 2016, Exchange Server 2019, Exchange Online |
-CompleteAfter
Este parámetro solo está disponible en el servicio basado en la nube.
El parámetro CompleteAfter especifica un retraso antes de que se complete el usuario. Se iniciará la migración de datos para el usuario, pero no se completará hasta la fecha y hora que especifique con este parámetro.
Use el formato de fecha corta que se define en la opción Configuración regional en el equipo en el que se ejecuta el comando. Por ejemplo, si el equipo está configurado para usar el formato de fecha corta mm/dd/yyyy, escriba 09/01/2018 para especificar el 1 de septiembre de 2018. Puede escribir solo la fecha, o la fecha y la hora del día. Si escribe la fecha y la hora del día, encierre el valor entre comillas ("), por ejemplo, "01/09/2018 5:00 PM".
En Exchange Online PowerShell, si especifica un valor de fecha y hora sin una zona horaria, el valor está en hora universal coordinada (UTC).
Para especificar un valor de fecha y hora para este parámetro, use una de las siguientes opciones:
- Especifique el valor de fecha y hora en UTC: por ejemplo, "2021-05-06 14:30:00z".
- Especifique el valor de fecha y hora como una fórmula que convierta la fecha y hora de la zona horaria local en UTC: por ejemplo,
(Get-Date "5/6/2021 9:30 AM").ToUniversalTime(). Para obtener más información, vea Get-Date.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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 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 2016, Exchange Server 2019 |
-Identity
El parámetro Identity especifica la dirección de correo electrónico del usuario que se va a migrar.
También puede identificar al usuario por el valor GUID de la propiedad MigrationUser desde la salida del cmdlet Get-MigrationUser. Este método de identificación es útil si envió accidentalmente al mismo usuario en varios lotes.
| Type: | MigrationUserIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-LargeItemLimit
El parámetro LargeItemLimit especifica el número máximo de elementos grandes que se permiten antes de que se produzca un error en la solicitud de migración. 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 se producirá un error en la solicitud de migración si se detecta algún elemento grande. Si está de acuerdo con dejar algunos elementos grandes atrás, puede establecer este parámetro en un valor razonable (se recomienda 10 o inferior) para que la solicitud de migración pueda continuar.
Nota: Este parámetro está en desuso. 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 2016, Exchange Server 2019, Exchange Online |
-Partition
Este parámetro solo está disponible en el servicio basado en la nube.
Este parámetro está reservado para uso interno de Microsoft.
| Type: | MailboxIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-StartAfter
Este parámetro solo está disponible en el servicio basado en la nube.
El parámetro StartAfter especifica un retraso antes de que se inicie la migración de datos para el usuario. La migración se preparará, pero la migración de datos real para el usuario no se iniciará hasta la fecha y hora que especifique con este parámetro.
Use el formato de fecha corta que se define en la opción Configuración regional en el equipo en el que se ejecuta el comando. Por ejemplo, si el equipo está configurado para usar el formato de fecha corta mm/dd/yyyy, escriba 09/01/2018 para especificar el 1 de septiembre de 2018. Puede escribir solo la fecha, o la fecha y la hora del día. Si escribe la fecha y la hora del día, encierre el valor entre comillas ("), por ejemplo, "01/09/2018 5:00 PM".
En Exchange Online PowerShell, si especifica un valor de fecha y hora sin una zona horaria, el valor está en hora universal coordinada (UTC).
Para especificar un valor de fecha y hora para este parámetro, use una de las siguientes opciones:
- Especifique el valor de fecha y hora en UTC: por ejemplo, "2021-05-06 14:30:00z".
- Especifique el valor de fecha y hora como una fórmula que convierta la fecha y hora de la zona horaria local en UTC: por ejemplo,
(Get-Date "5/6/2021 9:30 AM").ToUniversalTime(). Para obtener más información, vea Get-Date.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-SyncNow
El modificador SyncNow especifica si se debe desencadenar una sincronización incremental para el usuario migrado. No es necesario especificar un valor con este modificador.
Una sincronización incremental copia los cambios recientes del buzón de origen en el buzón de destino. Puede realizar una sincronización incremental antes de completar el lote de migración para reducir el tiempo necesario para la finalización.
| 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 |
-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 2016, Exchange Server 2019, Exchange Online |