Conexión a Exchange Online PowerShell

El módulo de PowerShell V2 de Exchange Online (abreviado como el módulo EXO V2) usa la autenticación moderna y funciona con la autenticación multifactor (MFA) para conectarse a todos los entornos de PowerShell relacionados con Exchange en Microsoft 365: PowerShell de Exchange Online, PowerShell de Seguridad y Cumplimiento normativo y PowerShell de Exchange Online Protection (EOP) independiente. Para más información sobre el módulo EXO V2, consulte Acerca del Módulo de Exchange Online PowerShell V2.

Este tema contiene instrucciones para conectarse a PowerShell de Exchange Online con el módulo EXO V2 con o sin MFA.

Para usar las instrucciones antiguas de conexión a PowerShell remoto, que son menos seguras y que quedarán obsoletas, vea Autenticación básica: conectar a PowerShell de Exchange Online.

Para usar el antiguo módulo remoto de PowerShell de Exchange Online para conectarse a PowerShell de Exchange Online utilizando MFA, vea Módulo V1: conectarse a PowerShell de Exchange Online mediante MFA. Tenga en cuenta que esta versión anterior del módulo se terminará por retirar.

¿Qué necesita saber antes de empezar?

  • Los requisitos para instalar y usar el módulo EXO V2 se describen en Instalar y mantener el módulo EXO V2. El resto de las instrucciones del tema asume que ya instaló el módulo.

  • Si su organización usa Exchange local y usted tiene licencias de Exchange Enterprise CAL con servicios para Exchange Online Protection (EOP), las instrucciones de conexión de EOP PowerShell serán las mismas que las de Exchange Online PowerShell tal cual se describen en este tema.

Tip

¿Problemas? Pregunte en el foro Exchange Online.

Conexión a Exchange Online PowerShell con MFA

Si su cuenta usa la autenticación multifactor, siga los pasos de esta sección. En caso contrario, vaya a la sección Conectarse a PowerShell de Exchange Online sin usar MFA.

  1. En una ventana de Windows PowerShell, cargue el módulo EXO V2 ejecutando el comando siguiente:

    Import-Module ExchangeOnlineManagement
    

    Nota: Si ya instaló el módulo EXO V2, el comando anterior funcionará como está escrito.

  2. El comando que necesita ejecutar usa la sintaxis siguiente:

    Connect-ExchangeOnline -UserPrincipalName <UPN> -ShowProgress $true [-ExchangeEnvironmentName <Value>] [-DelegatedOrganization <String>]
    
    • <UPN> es su cuenta en el formato del nombre principal de usuario (por ejemplo, navin@contoso.com).
    • Cuando usa el parámetro ExchangeEnvironmentName, no es necesario usar los parámetros ConnectionUri o AzureADAuthorizationEndPointUrl. Para más información, consulte las descripciones de parámetros en Connect-ExchangeOnline.
    • El parámetro DelegatedOrganization especifica la organización del cliente que desea administrar como partner autorizado. Para más información, vea Partners.

    Este ejemplo se conecta al PowerShell de Exchange Online en una organización de Microsoft 365 o Microsoft 365 GCC:

    Connect-ExchangeOnline -UserPrincipalName navin@contoso.com -ShowProgress $true
    

    Este ejemplo se conecta al PowerShell de Exchange Online en una organización de Office 365 Germany:

    Connect-ExchangeOnline -UserPrincipalName lukas@fabrikam.de -ShowProgress $true -ExchangeEnvironmentName O365GermanyCloud
    

    Este ejemplo se conecta al PowerShell de Exchange Online en una organización de Microsoft GCC High:

    Connect-ExchangeOnline -UserPrincipalName laura@blueyonderairlines.us -ShowProgress $true -ExchangeEnvironmentName O365USGovGCCHigh
    

    Este ejemplo se conecta al PowerShell de Exchange Online en una organización de Microsoft 365 DoD:

    Connect-ExchangeOnline -UserPrincipalName julia@adatum.mil -ShowProgress $true -ExchangeEnvironmentName O365USGovDoD
    

    Este ejemplo se conecta al PowerShell de Exchange Online para administrar otro espacio empresarial:

    Connect-ExchangeOnline -UserPrincipalName navin@contoso.com -DelegatedOrganization adatum.onmicrosoft.com
    

Para obtener información detallada acerca de la sintaxis y los parámetros, consulte Connect-ExchangeOnline.

Note

Asegúrese de desconectar la sesión remota de PowerShell cuando haya terminado. Si cierra la ventana de Windows PowerShell sin desconectar la sesión, podría agotar todas las sesiones de PowerShell remotas que tenga disponibles y deberá esperar a que las sesiones expiren. Ejecute el siguiente comando para desconectar la sesión de PowerShell remota.

Disconnect-ExchangeOnline

Conexión a PowerShell de Exchange Online sin MFA

Si su cuenta no usa la autenticación multifactor, siga los pasos de esta sección.

  1. En una ventana de Windows PowerShell, cargue el módulo EXO V2 ejecutando el comando siguiente:

    Import-Module ExchangeOnlineManagement
    

    Nota: Si ya instaló el módulo EXO V2, el comando anterior funcionará como está escrito.

  2. Ejecute el siguiente comando:

    $UserCredential = Get-Credential
    

    En el cuadro de diálogo Solicitud de credenciales para Windows PowerShell que aparece, escriba el usuario de su cuenta profesional o educativa y la contraseña, y luego haga clic en Aceptar.

  3. El comando que necesita ejecutar usa la sintaxis siguiente:

    Connect-ExchangeOnline -Credential $UserCredential -ShowProgress $true [-ExchangeEnvironmentName <Value>] [-DelegatedOrganization <String>]
    
    • Cuando usa el parámetro ExchangeEnvironmentName, no es necesario usar los parámetros ConnectionUri o AzureADAuthorizationEndPointUrl. Para más información, consulte las descripciones de parámetros en Connect-ExchangeOnline.
    • El parámetro DelegatedOrganization especifica la organización del cliente que desea administrar como partner autorizado. Para más información, vea Partners.

    Conectar al PowerShell de Exchange Online en una organización de Microsoft 365 o Microsoft 365 GCC:

    Connect-ExchangeOnline -Credential $UserCredential -ShowProgress $true
    

    Conectar al PowerShell de Exchange Online en una organización de Office 365 Germany:

    Connect-ExchangeOnline -Credential $UserCredential -ShowProgress $true -ExchangeEnvironmentName O365GermanyCloud
    

    Conectar al PowerShell de Exchange Online en una organización de Office 365 operada por 21Vianet:

    Connect-ExchangeOnline -Credential $UserCredential -ShowProgress $true -ExchangeEnvironmentName O365China
    

    Conectar al PowerShell de Exchange Online en una organización de Microsoft 365 GCC High:

    Connect-ExchangeOnline -Credential $UserCredential -ShowProgress $true -ExchangeEnvironmentName O365USGovGCCHigh
    

    Conectar al PowerShell de Exchange Online en una organización de Microsoft 365 DoD:

    Connect-ExchangeOnline -Credential $UserCredential -ShowProgress $true -ExchangeEnvironmentName O365USGovDoD
    

Para obtener información detallada acerca de la sintaxis y los parámetros, consulte Connect-ExchangeOnline.

Note

Asegúrese de desconectar la sesión remota de PowerShell cuando haya terminado. Si cierra la ventana de Windows PowerShell sin desconectar la sesión, podría agotar todas las sesiones de PowerShell remotas que tenga disponibles y deberá esperar a que las sesiones expiren. Ejecute el siguiente comando para desconectar la sesión de PowerShell remota.

Disconnect-ExchangeOnline

¿Cómo saber si el proceso se completó correctamente?

Los cmdlets de Exchange Online se importan en la sesión local de Windows PowerShell, tal y como se indica en una barra de progreso. Si no se muestra ningún error, la conexión se habrá establecido correctamente. Una prueba rápida consiste en ejecutar un cmdlet de PowerShell de Exchange Online como, por ejemplo, Get-Mailbox, y ver los resultados.

Si surgen errores, compruebe los siguientes requisitos:

  • Un problema habitual es una contraseña incorrecta. Vuelva a realizar los tres pasos y preste especial atención al nombre de usuario y contraseña que escriba en el paso 1.

  • Para evitar que se produzcan ataques por denegación de servicio (DoS), solo se pueden tener abiertas tres conexiones de PowerShell para la organización de Exchange Online.

  • La cuenta que usa para conectarse debe estar habilitada para PowerShell remoto. Para obtener más información, vea Habilitar o deshabilitar el acceso a PowerShell de Exchange Online.

  • Debe abrir el tráfico del puerto TCP 80 entre su equipo local y Microsoft 365. Probablemente esté abierto, pero es un aspecto que se debe tener en cuenta si la directiva de acceso a Internet de su organización es restrictiva.

  • Si su organización usa la autenticación federada, y el proveedor de identidades (IDP) o el servicio de token de seguridad (STS) no están disponibles públicamente, no podrá usar una cuenta federada para conectarse a Exchange Online PowerShell. En su lugar, cree y use una cuenta no federada en Microsoft 365 para conectarse a Exchange Online PowerShell.