Set-MigrationEndpoint
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-MigrationEndpoint para editar la configuración de las migraciones de Exchange por fases o de transición, migraciones IMAP, migraciones de Google Workspace (anteriormente G Suite) y movimientos remotos.
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-MigrationEndpoint
[-Identity] <MigrationEndpointIdParameter>
[-AcceptUntrustedCertificates <Boolean>]
[-ApplicationId <String>]
[-AppSecretKeyVaultUrl <String>]
[-Authentication <AuthenticationMethod>]
[-Confirm]
[-Credentials <PSCredential>]
[-DomainController <Fqdn>]
[-ExchangeServer <String>]
[-MailboxPermission <MigrationMailboxPermission>]
[-MaxConcurrentIncrementalSyncs <Unlimited>]
[-MaxConcurrentMigrations <Unlimited>]
[-NspiServer <String>]
[-Partition <MailboxIdParameter>]
[-Port <Int32>]
[-PublicFolderDatabaseServerLegacyDN <String>]
[-RemoteServer <Fqdn>]
[-RpcProxyServer <Fqdn>]
[-Security <IMAPSecurityMechanism>]
[-ServiceAccountKeyFileData <Byte[]>]
[-SkipVerification]
[-SourceMailboxLegacyDN <String>]
[-TestMailbox <MailboxIdParameter>]
[-WhatIf]
[<CommonParameters>]
Description
Use el cmdlet Set-MigrationEndpoint para ajustar la configuración de distintos tipos de migración:
- Movimiento entre bosques: mueva buzones entre dos bosques de Exchange locales diferentes. Los movimientos entre bosques requieren el uso de un extremo de RemoteMove.
- Movimiento remoto: en una implementación híbrida, un movimiento remoto implica la incorporación o eliminación de migraciones. Los movimientos remotos requieren el uso de un extremo de RemoteMove. La incorporación mueve los buzones de una organización de Exchange local a Exchange Online y usa un punto de conexión RemoteMove como punto de conexión de origen del lote de migración. El offboarding mueve los buzones de Exchange Online a una organización de Exchange local y usa un punto de conexión RemoteMove como punto de conexión de destino del lote de migración.
- Migración total de Exchange: migre todos los buzones de una organización de Exchange local a Exchange Online. La migración de Exchange de transición requiere el uso de un punto de conexión de Exchange.
- Migración de Exchange almacenada provisionalmente: migre un subconjunto de buzones de una organización de Exchange local a Exchange Online. La migración de Exchange almacenada provisionalmente requiere el uso de un punto de conexión de Exchange.
- Migración IMAP: migre los datos de buzón de correo de una organización de Exchange local u otro sistema de correo electrónico a Exchange Online. Para migrar datos de un servidor IMAP, primero debe crear los buzones de correo basados en la nube antes de migrar los datos. Las migraciones de IMAP requieren el uso de un extremo de IMAP.
- Migración de Gmail: migración de datos de buzón de correo desde un inquilino de Google Workspace a Exchange Online. Para una migración de Google Workspace, primero debe crear los usuarios o buzones de correo basados en la nube antes de migrar los datos del buzón. Las migraciones de Google Workspace requieren el uso de un punto de conexión de Gmail.
- Local: mueva buzones entre diferentes servidores o bases de datos dentro de un único bosque de Exchange local. Los movimientos locales no requieren el uso de un extremo.
Para obtener más información sobre otros escenarios de movimiento y migración, consulte:
- El buzón se mueve en Exchange Server
- Administración de movimientos de buzones locales en Exchange Server
Los cambios realizados en un punto de conexión que afectan a los usuarios individuales del lote se aplican a partir de la próxima vez que se procese el lote. Si ejecuta este cmdlet en el servicio basado en la nube y desea acelerar la aplicación de esta configuración, considere la posibilidad de ejecutar el cmdlet Set-MigrationBatch con el parámetro -Update.
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-MigrationEndpoint -Identity CutoverExchangeEndpoint01 -MaxConcurrentIncrementalSyncs 50 -NspiServer Server01.contoso.com
En este ejemplo se cambia la configuración de MaxConcurrentIncrementalSyncs a 50 en el extremo de migración CutoverExchangeEndpoint01 con el servidor NSPI Server01.
Ejemplo 2
Set-MigrationEndpoint -Identity Onboardingmigrationendpoint01 -MaxConcurrentMigrations 10 -RemoteServer Server01.contoso.com
En este ejemplo se cambia la configuración de MaxConcurrentMigrations a 10 en el extremo de migración Onboardingmigrationendpoint01 con el servidor remoto Server01.
Parámetros
-AcceptUntrustedCertificates
Este parámetro solo está disponible en el servicio basado en la nube.
{{ Fill AcceptUntrustedCertificates Description }}
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-ApplicationId
Este parámetro solo está disponible en el servicio basado en la nube.
{{ Fill ApplicationId Description }}
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-AppSecretKeyVaultUrl
Este parámetro solo está disponible en el servicio basado en la nube.
{{ Fill AppSecretKeyVaultUrl Description }}
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-Authentication
Este parámetro solo está disponible en el servicio basado en la nube.
El parámetro Authentication especifica el método de autenticación utilizado por el servidor de correo remoto.
Type: | AuthenticationMethod |
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 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Credentials
El parámetro Credentials especifica el nombre de usuario y la contraseña para conectarse al punto de conexión remoto. Las credenciales se deben usar al crear un punto de conexión de Exchange preconfigurado o de transición o un punto de conexión de RemoteMove.
Un valor para este parámetro requiere el cmdlet Get-Credential. Para pausar este comando y recibir una solicitud de credenciales, use el valor (Get-Credential)
. O bien, antes de ejecutar este comando, almacene las credenciales en una variable (por ejemplo, $cred = Get-Credential
) y, a continuación, use el nombre de variable ($cred
) para este parámetro. Para más información, vea Get-Credential.
Type: | PSCredential |
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 |
-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 |
-ExchangeServer
Este parámetro solo está disponible en el servicio basado en la nube.
El parámetro ExchangeServer especifica el servidor exchange de origen local para las migraciones de transición y preconfiguradas. Este parámetro solo se aplica a los puntos de conexión de Exchange preconfigurados y de transición que no usan la detección automática.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-Identity
El parámetro Identity especifica el nombre del extremo de migración que desea configurar.
Type: | MigrationEndpointIdParameter |
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 |
-MailboxPermission
Este parámetro solo está disponible en el servicio basado en la nube.
El parámetro MailboxPermission especifica los permisos que se deben usar para tener acceso al buzón de origen durante la incorporación de Outlook Anywhere (migración preconfigurada de Exchange o migración total de Exchange). Este parámetro solo es válido para las migraciones de Outlook Anywhere.
La cuenta especificada debe tener los siguientes permisos:
- Permiso de acceso total. La cuenta tiene permisos de acceso total a los buzones que se quieren migrar.
- Administración permiso. La cuenta es un administrador de dominio que puede acceder a cualquier buzón que quiera migrar.
Type: | MigrationMailboxPermission |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-MaxConcurrentIncrementalSyncs
El parámetro MaxConcurrentIncrementalSyncs especifica el número máximo de sincronizaciones incrementales permitidas para este extremo en un momento determinado. Este valor debe ser menor o igual al parámetro MaxConcurrentMigrations.
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 |
-MaxConcurrentMigrations
El parámetro MaxConcurrentMigrations especifica el número máximo de buzones que se migrarán para este extremo en un momento determinado. Este parámetro se aplica a todos los tipos de migración.
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 |
-NspiServer
Este parámetro solo está disponible en el servicio basado en la nube.
El parámetro NspiServer especifica el FQDN del servidor remoto de la interfaz del proveedor de servicio de nombres (NSPI). Este parámetro solo se aplica a los puntos de conexión de Exchange preconfigurados y de transición que no usan la detección automática.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | 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 |
-Port
Este parámetro solo está disponible en el servicio basado en la nube.
En una migración de servidor IMAP, el parámetro Port especifica el número de puerto TCP usado en el proceso de migración para conectarse al servidor remoto.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-PublicFolderDatabaseServerLegacyDN
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: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-RemoteServer
El parámetro RemoteServer especifica el servidor remoto en función del tipo de protocolo para los movimientos:
- Movimientos del servidor de Exchange: el FQDN de un servidor de Exchange que tiene instalado el rol acceso de cliente, una matriz de servidores de acceso de cliente o un grupo de servidores de acceso de cliente que se encuentran detrás de un equilibrador de carga de red compatible.
- Movimientos IMAP: el FQDN del servidor IMAP.
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, Exchange Online |
-RpcProxyServer
Este parámetro solo está disponible en el servicio basado en la nube.
Para una migración de Exchange almacenada provisionalmente, el parámetro RpcProxyServer especifica el FQDN del servidor proxy RPC para el servidor exchange local. Este parámetro solo se aplica a los puntos de conexión de Exchange preconfigurados y de transición que no usan la detección automática.
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-Security
Este parámetro solo está disponible en el servicio basado en la nube.
Para una migración IMAP, el parámetro Security especifica el método de cifrado utilizado por el servidor de correo remoto. Las opciones son None, Tls o Ssl.
Type: | IMAPSecurityMechanism |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-ServiceAccountKeyFileData
Este parámetro solo está disponible en el servicio basado en la nube.
El parámetro ServiceAccountKeyFileData se usa para especificar la información necesaria para autenticarse como una cuenta de servicio. Los datos deben proceder del archivo de clave JSON que se descarga cuando se crea la cuenta de servicio a la que se ha concedido acceso al inquilino remoto.
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
).
Type: | Byte[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-SkipVerification
El modificador SkipVerification omite la comprobación de que el servidor remoto es accesible al crear un punto de conexión de migración. 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 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SourceMailboxLegacyDN
Este parámetro solo está disponible en el servicio basado en la nube.
El parámetro SourceMailboxLegacyDN especifica un buzón de correo en el servidor de destino. Use LegacyExchangeDN para el buzón local de prueba como valor para este parámetro. El cmdlet intenta tener acceso a este buzón con las credenciales de la cuenta de administrador del servidor de destino.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-TestMailbox
Este parámetro solo está disponible en el servicio basado en la nube.
El parámetro TestMailbox especifica un buzón de correo en el servidor de destino. Utilice la dirección principal SMTP como el valor de este parámetro. El cmdlet intenta tener acceso a este buzón con las credenciales de la cuenta de administrador del servidor de destino.
Type: | MailboxIdParameter |
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 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.