Test-MigrationServerAvailability

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 Test-MigrationServerAvailability para probar la disponibilidad del servidor de destino en preparación para realizar movimientos de buzones entre bosques, migración de buzones locales a Exchange Online o para migrar datos de buzones locales de un servidor IMAP a buzones de Exchange Online. Para todos los tipos de migración, el cmdlet intenta comprobar la configuración de conexión usada para conectarse al servidor de destino.

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

Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -EmailAddress <SmtpAddress>
    [-Autodiscover]
    [-ExchangeRemoteMove]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]
Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -EmailAddress <SmtpAddress>
    [-Autodiscover]
    [-ExchangeOutlookAnywhere]
    [-AcceptUntrustedCertificates]
    [-Confirm]
    [-MailboxPermission <MigrationMailboxPermission>]
    [-Partition <MailboxIdParameter>]
    [-SourceMailboxLegacyDN <String>]
    [-TestMailbox <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]
Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -RemoteServer <Fqdn>
    [-FilePath <String>]
    [-PSTImport]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]
Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -ExchangeServer <String>
    -RPCProxyServer <Fqdn>
    [-ExchangeOutlookAnywhere]
    [-AcceptUntrustedCertificates]
    [-Authentication <AuthenticationMethod>]
    [-EmailAddress <SmtpAddress>]
    [-MailboxPermission <MigrationMailboxPermission>]
    [-TestMailbox <MailboxIdParameter>]
    [-SourceMailboxLegacyDN <String>]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]
Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -PublicFolderDatabaseServerLegacyDN <String>
    -RPCProxyServer <Fqdn>
    -SourceMailboxLegacyDN <String>
    [-PublicFolder]
    [-Authentication <AuthenticationMethod>]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-TestMailbox <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]
Test-MigrationServerAvailability
    -RemoteServer <Fqdn>
    [-Credentials <PSCredential>]
    [-ExchangeRemoteMove]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]
Test-MigrationServerAvailability
    -Endpoint <MigrationEndpointIdParameter>
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]
Test-MigrationServerAvailability
    -RemoteServer <Fqdn>
    -Port <Int32>
    [-Imap]
    [-AcceptUntrustedCertificates]
    [-Authentication <AuthenticationMethod>]
    [-Security <NIMAPSecurityMechanism]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]
Test-MigrationServerAvailability
    -ServiceAccountKeyFileData <Byte[]>
    [-Gmail]
    [-EmailAddress <SmtpAddress>]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-TestMailbox <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]
Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -EmailAddress <SmtpAddress>
    [-Compliance]
    [-RemoteServer <Fqdn>]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]
Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -RemoteServer <Fqdn>
    [-PublicFolderToUnifiedGroup]
    [-TestMailbox <MailboxIdParameter>]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]
Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -PublicFolderDatabaseServerLegacyDN <String>
    -RPCProxyServer <Fqdn>
    -SourceMailboxLegacyDN <String>
    [-PublicFolderToUnifiedGroup]
    [-Authentication <AuthenticationMethod>]
    [-TestMailbox <MailboxIdParameter>]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]
Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -RemoteServer <Fqdn>
    [-PublicFolder]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

Description

El cmdlet Test-MigrationServerAvailability comprueba que puede comunicarse con el servidor de correo local que contiene los datos de buzón que desea migrar a buzones basados en la nube. Al ejecutar este cmdlet, debe especificar el tipo de migración. Puede especificar si se va a comunicar con un servidor IMAP o con un servidor exchange.

Para una migración IMAP, este cmdlet usa el nombre de dominio completo (FQDN) del servidor y un número de puerto para comprobar la conexión. Si la comprobación se realiza correctamente, use la misma configuración de conexión al crear una solicitud de migración con el cmdlet New-MigrationBatch.

Para una migración de Exchange, este cmdlet usa una de las siguientes opciones de configuración para comunicarse con el servidor local:

  • Para Exchange 2003, usa el FQDN del servidor y las credenciales de una cuenta de administrador que puede acceder al servidor.
  • Para Exchange Server 2007 y versiones posteriores, puede conectarse mediante el servicio Detección automática y la dirección de correo electrónico de una cuenta de administrador que puede acceder al servidor.

Si la comprobación se realiza correctamente, puede usar la misma configuración para crear un punto de conexión de migración. Para obtener más información, consulte:

  • New-MigrationEndpoint
  • New-MigrationBatch

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

Test-MigrationServerAvailability -Imap -RemoteServer imap.contoso.com -Port 143

En el caso de las migraciones IMAP, en este ejemplo se comprueba la conexión al servidor de correo IMAP imap.contoso.com.

Ejemplo 2

$Credentials = Get-Credential

Test-MigrationServerAvailability -ExchangeOutlookAnywhere -Autodiscover -EmailAddress administrator@contoso.com -Credentials $Credentials

En este ejemplo se usan los parámetros Detección automática y ExchangeOutlookAnywhere para comprobar la conexión a un servidor exchange local como preparación para migrar buzones locales a Exchange Online. Puede usar un ejemplo similar para probar la configuración de conexión para una migración de Exchange preconfigurada o una migración de Exchange de transición.

Ejemplo 3

$Credentials = Get-Credential

Test-MigrationServerAvailability -ExchangeOutlookAnywhere -ExchangeServer exch2k3.contoso.com -Credentials $Credentials -RPCProxyServer mail.contoso.com -Authentication NTLM

En este ejemplo se comprueba la conexión a un servidor que ejecuta Microsoft Exchange Server 2003 denominado exch2k3.contoso.com y se usa NTLM para el método de autenticación.

Ejemplo 4

Test-MigrationServerAvailability -Endpoint endpoint.contoso.com

En este ejemplo se comprueba la configuración de conexión a un servidor remoto mediante la configuración almacenada en un punto de conexión de migración existente en Exchange Online.

Ejemplo 5

$MRSEndpoints = (Get-MigrationEndpoint).Identity

Foreach ($MEP in $MRSEndpoints) {Test-MigrationServerAvailability -Endpoint $MEP}

En este ejemplo se prueban varios puntos de conexión existentes.

Parámetros

-AcceptUntrustedCertificates

Este parámetro solo está disponible en el servicio basado en la nube.

{{ Fill AcceptUntrustedCertificates Description }}

Type:SwitchParameter
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 que usa el servidor de correo local. Use Basic o NTLM. Si este parámetro no se incluye, se usa la autenticación Basic.

El parámetro solo se usa para migraciones de Exchange de transición y migraciones de Exchange almacenadas provisionalmente.

Type:AuthenticationMethod
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Autodiscover

El modificador Detección automática especifica que el comando debe usar el servicio Detección automática para obtener la configuración de conexión del servidor de destino. No es necesario especificar un valor con este modificador.

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

-Compliance

El modificador Cumplimiento especifica que el tipo de punto de conexión es cumplimiento. No es necesario especificar un valor con este modificador.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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

-Credentials

El parámetro Credentials especifica el nombre de usuario y la contraseña de una cuenta que puede acceder a buzones en el servidor de destino. Especifique el nombre de usuario en el formato domain\username o el formato de nombre principal de usuario (user@example.comUPN).

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:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-EmailAddress

El parámetro EmailAddress especifica la dirección de correo electrónico de una cuenta de administrador que tiene acceso al servidor remoto. Este parámetro es necesario cuando se usa el parámetro Detección automática.

Type:SmtpAddress
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

-Endpoint

El parámetro Endpoint especifica el nombre del punto de conexión de migración al que se va a conectar. Un punto de conexión de migración contiene la configuración de conexión y otras opciones de configuración de migración. Si incluye este parámetro, el cmdlet Test-MigrationServerAvailability intenta comprobar la capacidad de conectarse al servidor remoto mediante la configuración del punto de conexión de migración.

Type:MigrationEndpointIdParameter
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

-ExchangeOutlookAnywhere

Este parámetro solo está disponible en el servicio basado en la nube.

El modificador ExchangeOutlookAnywhere especifica un tipo de migración para migrar buzones locales a Exchange Online. No es necesario especificar un valor con este modificador.

Use este modificador si tiene previsto migrar buzones a Exchange Online mediante una migración provisional de Exchange o una migración de Exchange de transición.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ExchangeRemoteMove

El modificador ExchangeRemoteMove especifica un tipo de migración donde los buzones se mueven con plena fidelidad entre dos bosques locales o entre un bosque local y Exchange Online. No es necesario especificar un valor con este modificador.

Use este modificador si tiene previsto realizar un traslado entre bosques o migrar buzones entre una organización de Exchange local y Exchange Online en una implementación híbrida.

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

-ExchangeServer

Este parámetro solo está disponible en el servicio basado en la nube.

El parámetro ExchangeServer especifica el FQDN del servidor exchange local. Use este parámetro cuando planee realizar una migración de Exchange almacenada provisionalmente o una migración de Exchange de transición. Este parámetro es necesario si no usa el parámetro Detección automática.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-FilePath

El parámetro FilePath especifica la ruta de acceso que contiene los archivos PST al probar un punto de conexión de migración de importación de PST.

Type:String
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

-Gmail

Este parámetro solo está disponible en el servicio basado en la nube.

El parámetro Gmail especifica Gmail como tipo de migración. No es necesario especificar un valor con este modificador.

Este modificador es necesario cuando se desea migrar datos de un inquilino de Google Workspace (anteriormente G Suite) a Exchange Online buzones.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Imap

Este parámetro solo está disponible en el servicio basado en la nube.

El parámetro Imap especifica un tipo de migración IMAP. No es necesario especificar un valor con este modificador.

Este modificador es necesario cuando se desea migrar datos de un servidor de correo IMAP a Exchange Online buzones.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-MailboxPermission

Este parámetro solo está disponible en el servicio basado en la nube.

El parámetro MailboxPermission especifica qué permisos se asignan a la cuenta de administrador de migración definida por el parámetro Credentials. Realice la asignación de permisos para probar la conectividad con un buzón de usuario en el servidor de correo de origen al probar la configuración de conexión en preparación para una migración de Exchange preconfigurada o de transición o para crear un punto de conexión de migración de Exchange Outlook Anywhere.

Especifique uno de los siguientes valores para la cuenta definida por el parámetro Credentials:

  • FullAccess: a la cuenta se le ha asignado el permiso de Full-Access a los buzones que se migrarán.
  • Administración: La cuenta es miembro del grupo Administradores de dominio de la organización que hospeda los buzones que se migrarán.

Este parámetro no se usa para probar la conexión al servidor remoto para una migración de movimiento remoto o una migración IMAP.

Type:MigrationMailboxPermission
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.

El parámetro Port especifica el número de puerto TCP usado por el proceso de migración IMAP para conectarse al servidor de destino. Este parámetro solo es necesario para las migraciones IMAP.

El estándar es usar el puerto 143 para conexiones sin cifrar, el puerto 143 para la seguridad de la capa de transporte (TLS) y el puerto 993 para capa de sockets seguros (SSL).

Type:Int32
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-PSTImport

Este parámetro solo está disponible en Exchange local.

Este parámetro está reservado para uso interno de Microsoft.

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

-PublicFolder

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:True
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:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-PublicFolderToUnifiedGroup

El modificador PublicFolderToUnifiedGroup especifica que el tipo de punto de conexión es carpetas públicas para Grupos de Microsoft 365. No es necesario especificar un valor con este modificador.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-RemoteServer

El parámetro RemoteServer especifica el FQDN del servidor de correo local. Este parámetro es necesario cuando se desea realizar uno de los siguientes tipos de migración:

  • Movimiento entre bosques
  • Movimiento remoto (implementaciones híbridas)
  • Migración de IMAP
Type:Fqdn
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

-RPCProxyServer

Este parámetro solo está disponible en el servicio basado en la nube.

El parámetro RPCProxyServer especifica el FQDN del servidor proxy RPC para el servidor exchange local. Este parámetro es necesario cuando no se usa el parámetro Detección automática. Use este parámetro si tiene previsto realizar una migración de Exchange preconfigurada o una migración de Exchange de transición para migrar buzones a Exchange Online.

Type:Fqdn
Position:Named
Default value:None
Required:True
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:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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 intentará acceder a este buzón con las credenciales de la cuenta de administrador en el servidor de destino.

Type:String
Position:Named
Default value:None
Required:True
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 intentará acceder a este buzón con las credenciales de la cuenta de administrador en el 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.