Conectarse a Microsoft 365 con PowerShell

Este artículo afecta tanto a Office 365 Enterprise como a Microsoft 365 Enterprise

PowerShell para Microsoft 365 le permite administrar la configuración de Microsoft 365 desde la línea de comandos. Para conectarse a PowerShell, solo tiene que instalar el software necesario y después conectarse a su organización de Microsoft 365.

Hay dos versiones del módulo de PowerShell que puede usar para conectarse a Microsoft 365 y administrar cuentas de usuario, grupos y licencias:

  • Azure Active Directory PowerShell para Graph, cuyos cmdlets incluyen AzureAD en su nombre
  • Módulo Microsoft Azure Active Directory para Windows PowerShell, cuyos cmdlets incluyen Msol en su nombre

Actualmente, el Módulo Azure Active Directory PowerShell para Graph no reemplaza completamente la funcionalidad del Módulo Microsoft Azure AD para Windows PowerShell para la administración de usuarios, grupos y licencias. En algunos casos, deberá usar ambas versiones. Puede instalar ambas versiones de forma segura en el mismo equipo.

Nota

También puede conectarse con Azure Cloud Shell desde el Centro de administración de Microsoft 365.

¿Qué necesita saber antes de empezar?

Nota

El módulo de Azure Active Directory se va reemplazar por el SDK de PowerShell de Microsoft Graph. Puede usar el SDK de PowerShell de Microsoft Graph para acceder a todas las API de Microsoft Graph. Para más información, consulte Introducción al SDK de PowerShell de Microsoft Graph.

Sistema operativo

Use una versión de 64 bits de Windows. La compatibilidad con la versión de 32 bits de Módulo Microsoft Azure Active Directory para Windows PowerShell se descontinuó en 2014.

Puede usar las siguientes versiones de Windows:

  • Windows 10, Windows 8.1, Windows 8 o Windows 7 Service Pack 1 (SP1)

  • Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012 o Windows Server 2008 R2 SP1

Nota

Para Windows 8.1, Windows 8, Windows 7 Service Pack 1 (SP1), Windows Server 2012 R2, Windows Server 2012 y Windows Server 2008 R2 SP1, descargue e instale Windows Management Framework 5.1.

PowerShell

  • Para el PowerShell de Azure Active Directory para el módulo de Graph, debe usar PowerShell versión 5.1.

  • Para el Módulo Microsoft Azure Active Directory para Windows PowerShell, debe usar la versión 5.1 o posterior de PowerShell, hasta la versión 6 de PowerShell. No puede usar la versión 7 de PowerShell.

Nota

Estos procedimientos están destinados a los usuarios que son miembros de un rol de administrador de Microsoft 365. Para obtener más información, vea Acerca de los roles de administrador.

Conéctese al módulo de PowerShell de Azure Active Directory para Graph

Los comandos del módulo PowerShell Azure Active Directory para Graph incluyen AzureAD en su nombre de cmdlet. Puede instalar el módulo Azure Active Directory PowerShell para Graph o Azure PowerShell.

Para los procedimientos que necesitan los nuevos cmdlets del Módulo Azure Active Directory PowerShell para Graph, siga estos pasos para instalar el módulo y conectarse a su suscripción a Microsoft 365.

Nota

Para información sobre la compatibilidad con diferentes versiones de Windows, vea Módulo Azure Active Directory PowerShell para Graph .

Paso 1: Instalar el software necesario

Estos pasos son necesarios solo una vez en el equipo. Pero es probable que tenga que actualizar el software periódicamente.

  1. Abra una ventana de símbolo del sistema de Windows PowerShell con privilegios elevados (ejecute Windows PowerShell como administrador).

  2. Ejecute este comando:

    Install-Module -Name AzureAD
    

De forma predeterminada, la Galería de PowerShell (PSGallery) no está configurada como repositorio de confianza para PowerShellGet. La primera vez que use PSGallery, verá el siguiente mensaje:

Untrusted repository

You are installing the modules from an untrusted repository. If you trust this repository, change its InstallationPolicy value by running the `Set-PSRepository` cmdlet.

Are you sure you want to install the modules from 'PSGallery'?
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"):

Responda o Sí a todo para continuar con la instalación.

  1. Ejecute este comando para importar el módulo:

    Import-Module  AzureAD
    

Paso 2: Conectarse a Azure AD para la suscripción de Microsoft 365

Para conectarse a Azure AD para la suscripción de Microsoft 365 con un nombre de cuenta y contraseña o con la autenticación multifactor (MFA), ejecute uno de estos comandos desde un símbolo del sistema de Windows PowerShell (no tiene que ser elevado).

Nube de Office 365 Comando
Office 365 Worldwide (+GCC) Connect-AzureAD
Office 365 ofrecido por 21Vianet Connect-AzureAD -AzureEnvironmentName AzureChinaCloud
Office 365 Germany Connect-AzureAD -AzureEnvironmentName AzureGermanyCloud
Office 365 U.S. Government DoD y Office 365 U.S. Government GCC High Connect-AzureAD -AzureEnvironmentName AzureUSGovernment

En el cuadro de diálogo Inicie sesión en su cuenta, escriba su nombre de usuario y contraseña de la cuenta profesional o educativa de Microsoft 365 y seleccione Aceptar.

Si está usando la autenticación multifactor, siga las instrucciones para proporcionar información de autenticación adicional, como un código de comprobación.

Después de conectarse, puede usar los cmdlets para el Módulo Azure Active Directory PowerShell para Graph.

Conectar con el Módulo Microsoft Azure Active Directory para Windows PowerShell

Nota

Los cmdlets del Módulo Microsoft Azure Active Directory para Windows PowerShell tienen Msol en su nombre.

La versión 7 de PowerShell no es compatible con el Módulo Microsoft Azure Active Directory para Windows PowerShell ni los cmdlets que llevan Msol en su nombre. Para PowerShell versión 7 y posteriores, debe usar el SDK de PowerShell de Microsoft Graph.

PowerShell Core no admite el Módulo Microsoft Azure Active Directory para Windows PowerShell ni los cmdlets con Msol en su nombre. Ejecute estos cmdlets desde Windows PowerShell.

Paso 1: Instalar el software necesario

Estos pasos son necesarios solo una vez en el equipo. Pero es probable que tenga que actualizar el software periódicamente.

  1. Si no ejecuta Windows 10, instale la versión de 32 bits del asistente para inicio de sesión de Microsoft Online Services - Ayudante para el inicio de sesión: Microsoft Online Services - Ayudante para el inicio de sesión para profesionales de TI RTW.

  2. Siga estos pasos para instalar el Módulo Microsoft Azure Active Directory para Windows PowerShell:

    1. Abra un símbolo del sistema de Windows PowerShell con privilegios elevados (ejecute Windows PowerShell como administrador).
    2. Ejecute el comando Install-Module MSOnline.
    3. Si se le pide que instale el proveedor de NuGet, escriba Y y presione Entrar.
    4. Si se le pide que instale el módulo desde PSGallery, escriba Y y presione Entrar.

Paso 2: Conectarse a Azure AD para la suscripción de Microsoft 365

Para conectarse a Azure AD para la suscripción de Microsoft 365 con un nombre de cuenta y contraseña o con la autenticación multifactor, ejecute uno de estos comandos desde un símbolo del sistema de Windows PowerShell (no tiene que ser elevado).

Nube de Office 365 Comando
Office 365 Worldwide (+GCC) Connect-MsolService
Office 365 ofrecido por 21Vianet Connect-MsolService -AzureEnvironment AzureChinaCloud
Office 365 Germany Connect-MsolService -AzureEnvironment AzureGermanyCloud
Office 365 U.S. Government DoD y Office 365 U.S. Government GCC High Connect-MsolService -AzureEnvironment USGovernment

En el cuadro de diálogo Inicie sesión en su cuenta, escriba su nombre de usuario y contraseña de la cuenta profesional o educativa de Microsoft 365 y seleccione Aceptar.

Si está usando la autenticación multifactor, siga las instrucciones para proporcionar información de autenticación adicional, como un código de comprobación.

¿Cómo sabrá que funcionó?

Si no recibe un mensaje de error, se ha conectado correctamente. Para realizar una prueba rápida, ejecute un cmdlet de Microsoft 365, como Get-MsolUser y vea los resultados.

Si recibe un mensaje de error, compruebe los siguientes problemas:

  • Un problema común es una contraseña incorrecta. Ejecute paso 2 de nuevo y preste especial atención al nombre de usuario y la contraseña que escriba.

  • El Módulo Microsoft Azure Active Directory para Windows PowerShell requiere que Microsoft .NET Framework 3.5. x está habilitado en el equipo**. Es probable que el equipo tenga instalada una versión más reciente (por ejemplo, 4 o 4.5.* x*). Sin embargo, la compatibilidad con versiones anteriores de la .NET Framework se puede habilitar o deshabilitar. Para obtener más información, vea los siguientes artículos:

  • Es posible que la versión del Módulo Microsoft Azure Active Directory para Windows PowerShell no esté actualizada. Para comprobarlo, ejecute el siguiente comando en PowerShell para Microsoft 365 o el Módulo Microsoft Azure Active Directory para Windows PowerShell:

    (Get-Item C:\Windows\System32\WindowsPowerShell\v1.0\Modules\MSOnline\Microsoft.Online.Administration.Automation.PSModule.dll).VersionInfo.FileVersion
    

    Si el número de versión devuelto es menor que 1.0.8070.2, desinstale el Módulo Microsoft Azure Active Directory para Windows PowerShell e instale de nuevo siguiendo el Paso 1 descrito anteriormente.

  • Si recibe un mensaje de error de conexión, consulte el Error "Connect-MsolService: se produjo una excepción de tipo".

  • Si recibe un mensaje de error "Obtener elemento: no se encontró la ruta de acceso", utilice este comando:

       (dir "C:\Program Files\WindowsPowerShell\Modules\MSOnline").Name
    

Conexión con Azure Cloud Shell

Para conectarse y usar el Azure Cloud Shell del Centro de administración de Microsoft 365, seleccione el icono de la ventana de PowerShell en la esquina superior derecha de la barra de tareas. En el panel Bienvenido a Azure Cloud Shell, luego seleccione Powershell.

Necesitará una suscripción de Azure activa para su organización que esté vinculada a su suscripción de Microsoft 365. Si aún no tiene una, puede crearla. Una vez que tenga una suscripción de Azure, se abrirá una ventana de PowerShell desde la que ejecutar comandos y scripts de PowerShell.

Para obtener más información, consulte Azure Cloud Shell.

Consulte también