Conectarse a Microsoft 365 con PowerShell

• 07/17/2020
• 6 minutos para leer
• • J
  • D
  • m
  • d

Este artículo se aplica tanto a Microsoft 365 Enterprise como a Office 365 Enterprise.

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

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

• Azure Active Directory PowerShell for Graph, cuyos cmdlets incluyen AzureAD en su nombre
• Microsoft Azure Active Directory Module for Windows PowerShell, cuyos cmdlets incluyen Msol en su nombre

Actualmente, el módulo Azure Active Directory PowerShell for Graph no sustituye completamente la funcionalidad del módulo Microsoft Azure Active Directory Module for Windows PowerShell para la administración de usuarios, grupos y licencias. En algunos casos, es necesario utilizar ambas versiones. Puede instalar con seguridad ambas versiones en el mismo equipo.

¿Qué necesita saber antes de empezar?

Sistema operativo

Debe utilizar una versión de 64 bits de Windows. La compatibilidad con la versión de 32 bits del módulo de Microsoft Azure Active Directory para Windows PowerShell finalizó en 2014.

Puede utilizar 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

PowerShell

• Para el módulo Azure Active Directory PowerShell for Graph, debe utilizar la versión 5 de PowerShell.1 o posterior.

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

Conéctese con el módulo Azure Active Directory PowerShell for Graph

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

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

Paso 1: Instale el software necesario

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

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

2. Ejecute este comando:

   Install-Module -Name AzureAD

   Si se le pide que instale un módulo de un repositorio no fiable, escriba Y y pulse Intro.

Paso 2: Conéctese a Azure AD para su suscripción a Microsoft 365

Para conectarse a Azure Active Directory (Azure AD) para su suscripción a Microsoft 365 con un nombre de cuenta y una contraseña o con autenticación multifactor, ejecute uno de estos comandos desde un símbolo del sistema de Windows PowerShell. (No es necesario que esté elevado.)

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

Si utiliza la autenticación multifactor, siga las instrucciones para proporcionar información de autenticación adicional, como un código de verificación.

Después de conectarse, puede utilizar los cmdlets del módulo Azure Active Directory PowerShell for Graph.

Conectarse con el módulo de Microsoft Azure Active Directory para Windows PowerShell

La versión 7 de PowerShell y posteriores no admiten el módulo de Microsoft Azure Active Directory para Windows PowerShell ni los cmdlets con Msol en su nombre. Para la versión 7 de PowerShell y posteriores, debe utilizar el módulo Azure Active Directory PowerShell para Graph o Azure PowerShell.

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

Paso 1: Instale el software necesario

Estos pasos son necesarios sólo una vez en su equipo. Pero es probable que necesite actualizar el software periódicamente.

1. Si no está ejecutando Windows 10, instale la versión de 64 bits del Asistente de inicio de sesión de Microsoft Online Services: Asistente de inicio de sesión de Microsoft Online Services para profesionales de TI RTW.

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

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

Paso 2: Conéctese a Azure AD para su suscripción a Microsoft 365

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

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

Si utiliza la autenticación multifactor, siga las instrucciones para proporcionar información de autenticación adicional, como un código de verificación.

¿Cómo sabe que ha funcionado?

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 obtiene un mensaje de error, compruebe los siguientes problemas:

• Un problema común es una contraseña incorrecta. Vuelva a ejecutar el paso 2 y preste atención al nombre de usuario y a la contraseña que introduzca.

• El módulo Microsoft Azure Active Directory para Windows PowerShell requiere que Microsoft .NET Framework 3.5.x esté habilitado en su equipo. Es probable que su ordenador tenga instalada una versión más reciente (por ejemplo, 4 o 4.5.x). Pero la compatibilidad con versiones anteriores de .NET Framework puede activarse o desactivarse. Para obtener más información, consulte los siguientes artículos:

  • Para Windows Server 2012 o Windows Server 2012 R2, consulte Habilitar .NET Framework 3.5 mediante el Asistente para agregar funciones y características.

  • Para Windows 7 o Windows Server 2008 R2, consulte No se puede abrir el módulo Azure Active Directory para Windows PowerShell.

  • Para Windows 10, Windows 8.1 y Windows 8, consulte Instalar .NET Framework 3.5 en Windows 10, Windows 8.1 y Windows 8.

• Es posible que su versión del módulo de 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 de Active Directory de Microsoft Azure 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 inferior a 1.0.8070.2, desinstale el Módulo de Active Directory de Microsoft Azure para Windows PowerShell e instálelo desde el paso 1, anterior.

• Si obtiene un mensaje de error de conexión, consulte el error «Connect-MsolService: Exception of type was thrown» error.

• Si obtiene un mensaje de error «Get-Item: No se puede encontrar la ruta», ejecute este comando:

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

Vea también

• Administrar Microsoft 365 con PowerShell
• Iniciar con PowerShell para Microsoft 365
• Conectarse a todos los servicios de Microsoft 365 en una sola ventana de Windows PowerShell

.