Set-MigrationBatch
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 Set-MigrationBatch para actualizar una solicitud de migración para un lote de usuarios. Para obtener más información, vea New-MigrationBatch.
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-MigrationBatch
[-Identity] <MigrationBatchIdParameter>
[-AllowIncrementalSyncs <Boolean>]
[-AllowUnknownColumnsInCsv <Boolean>]
[-ApproveSkippedItems]
[-AutoRetryCount <Int32>]
[-BadItemLimit <Unlimited>]
[-CSVData <Byte[]>]
[-CompleteAfter <DateTime>]
[-Confirm]
[-DomainController <Fqdn>]
[-LargeItemLimit <Unlimited>]
[-MoveOptions <MultiValuedProperty>]
[-NotificationEmails <MultiValuedProperty>]
[-Partition <MailboxIdParameter>]
[-ReportInterval <TimeSpan>]
[-SkipMerging <MultiValuedProperty>]
[-SkipMoving <MultiValuedProperty>]
[-SkipReports <Boolean>]
[-SourcePublicFolderDatabase <DatabaseIdParameter>]
[-StartAfter <DateTime>]
[-SyncNow]
[-Update]
[-WhatIf]
[<CommonParameters>] Description
El cmdlet Set-MigrationBatch configura los lotes de migración existentes para migrar buzones y datos de buzones en uno de los siguientes escenarios:
- Movimiento local
- Movimiento entre bosques
- Movimiento remoto
- Migración total de Exchange
- Migración de Exchange preconfigurada
- Migración de IMAP
- Migración de Google Workspace (anteriormente G Suite)
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-MigrationBatch -Identity MigrationBatch01 -ApproveSkippedItemsEn este ejemplo se actualiza MigrationBatch01 mediante la aprobación de todos los elementos omitidos para todos los usuarios del lote que se detectaron anteriormente.
Parámetros
-AllowIncrementalSyncs
Este parámetro solo está disponible en Exchange local.
El parámetro AllowIncrementalSyncs especifica si se deben habilitar o deshabilitar las sincronizaciones incrementales. Los valores admitidos son:
- $true: La sincronización incremental está habilitada. Todos los nuevos mensajes enviados al buzón de correo de origen se copian en el buzón de destino correspondiente una vez cada 24 horas.
- $false: la sincronización incremental está deshabilitada. El lote de migración pasará al estado Detenido cuando se complete la sincronización inicial. Para completar un lote de migración para movimientos locales, movimientos entre bosques o migraciones de movimiento remoto, debe habilitar la sincronización incremental.
| Type: | Boolean |
| 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 |
-AllowUnknownColumnsInCsv
El parámetro AllowUnknownColumnsInCsv especifica si se deben permitir columnas adicionales en el archivo CSV que no se usen en la migración. Los valores admitidos son:
- $true: La migración omite (omite silenciosamente) las columnas desconocidas en el archivo CSV (incluidas las columnas opcionales con encabezados de columna mal escritos). Todas las columnas desconocidas se tratan como columnas adicionales que no se usan por la migración.
- $false: se produce un error en la migración si hay columnas desconocidas en el archivo CSV. Este ajuste protege de los errores en los encabezados de columna. Este es el valor predeterminado.
| Type: | Boolean |
| 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 |
-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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-AutoRetryCount
Este parámetro solo está disponible en Exchange local.
El parámetro AutoRetryCount especifica la cantidad de intentos de reinicio del lote de migración para migrar los buzones de correo en los que se produjeron errores.
| Type: | Int32 |
| 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 |
-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á 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 |
-CompleteAfter
Este parámetro solo funciona en el servicio basado en la nube.
El parámetro CompleteAfter especifica un retraso antes de que se complete el lote. Se iniciará la migración de datos para el lote, pero la finalización 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, use cualquiera de las opciones siguientes:
- Especifique el valor de fecha y hora en UTC: por ejemplo,
"7/30/2020 9:00PM Z". - Especifique el valor de fecha y hora en la zona horaria local. Por ejemplo,
"7/30/2020 9:00PM -700". El valor se convertirá a UTC si no usa el parámetro TimeZone.
| Type: | DateTime |
| 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 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-CSVData
Este parámetro solo está disponible en Exchange local.
El parámetro CSVData especifica el archivo CSV que contiene información sobre los buzones del usuario que se van a mover o a migrar. Los atributos obligatorios en la fila de encabezado del archivo CSV varían según el tipo de migración.
Un valor válido para este parámetro requiere que lea el archivo en un objeto codificado en bytes mediante la sintaxis siguiente: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). Puede usar este comando como valor de parámetro o puede escribir la salida en una variable ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) y usar la variable como valor del parámetro ($data).
Nota: Este parámetro no valida la disponibilidad de los buzones en función del ámbito de RBAC. Todos los buzones especificados en el archivo CSV se migrarán, incluso si están fuera del ámbito de RBAC (por ejemplo, una unidad organizativa) que proporciona a los administradores permisos para migrar buzones.
| Type: | Byte[] |
| 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 |
-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 2013, Exchange Server 2016, Exchange Server 2019 |
-Identity
El parámetro Identity especifica el lote de migración que desea modificar. Puede usar cualquier valor que identifique de forma única el lote de migración. Por ejemplo:
- Nombre (el valor de la propiedad Identity)
- GUID (valor de la propiedad BatchGuid)
| Type: | MigrationBatchIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, 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á 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 |
-MoveOptions
El parámetro MoveOptions especifica las fases de la migración que desea omitir con fines de depuración. No utilice este parámetro a menos que se lo indique el Soporte técnico y el servicio al cliente de Microsoft o la documentación específica.
No utilice este parámetro con el parámetro SkipMoving.
| Type: | MultiValuedProperty |
| 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 |
-NotificationEmails
El parámetro NotificationEmails especifica una o más direcciones de correo a las que se envían los informes de estado de migración.
Si no utiliza este parámetro, no se envía el informe de estado.
Para especificar varios valores y sobrescribir las entradas existentes, use la siguiente sintaxis: Value1,Value2,...ValueN. Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| 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 |
-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 |
-ReportInterval
El parámetro ReportInterval especifica la frecuencia con la que se deben enviar informes por correo electrónico a las direcciones de correo electrónico enumeradas en NotificationEmails.
De forma predeterminada, los informes por correo electrónico se envían cada 24 horas para un lote. Si se establece este valor en 0, se indica que nunca se deben enviar informes para este lote.
Este parámetro solo debe usarse en el servicio basado en la nube.
| Type: | TimeSpan |
| 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 |
-SkipMerging
El parámetro SkipMerging especifica las fases de la migración que desea omitir con fines de depuración. No utilice este parámetro a menos que se lo indique el Soporte técnico y el servicio al cliente de Microsoft o la documentación específica.
| Type: | MultiValuedProperty |
| 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 |
-SkipMoving
Este parámetro se ha sustituido por el parámetro MoveOptions.
El parámetro SkipMoving especifica las fases de la migración que desea omitir con fines de depuración. No utilice este parámetro a menos que se lo indique el Soporte técnico y el servicio al cliente de Microsoft o la documentación específica.
| Type: | MultiValuedProperty |
| 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 |
-SkipReports
El modificador SkipReports especifica que desea omitir informes automáticos para la migración. No es necesario especificar un valor con este modificador.
| Type: | Boolean |
| 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 |
-SourcePublicFolderDatabase
Este parámetro solo está disponible en Exchange local.
El parámetro SourcePublicFolderDatabase especifica la base de datos de carpetas públicas de origen que se usa en una migración de carpetas públicas. 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: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-StartAfter
El parámetro StartAfter especifica un retraso antes de que se inicie la migración de datos para los usuarios del lote. La migración se preparará, pero la migración de datos real para los usuarios del lote 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, use cualquiera de las opciones siguientes:
- Especifique el valor de fecha y hora en UTC: por ejemplo,
"7/30/2020 9:00PM Z". - Especifique el valor de fecha y hora en la zona horaria local. Por ejemplo,
"7/30/2020 9:00PM -700". El valor se convertirá a UTC si no usa el parámetro TimeZone.
| Type: | DateTime |
| 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 |
-SyncNow
El modificador SyncNow inicia una sincronización inmediata para los usuarios que ya han alcanzado el estado Sincronizado, pero no reanuda ningún usuario con errores. No es necesario especificar un valor con este modificador.
Puede usar este modificador para acelerar los movimientos de incorporación mediante el conmutador justo antes de la finalización del movimiento. En el caso de las migraciones IMAP, puede usar este modificador después del cambio de registro MX.
| 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 |
-Update
El modificador Update establece la marca Update en el lote de migración. No es necesario especificar un valor con este modificador.
La marca Update desencadena que Migration Service vuelva a aplicar toda la configuración del punto de conexión, el lote y el usuario al proceso de migració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 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.
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de