Conectarse a Microsoft 365 con PowerShellConnect to Microsoft 365 with PowerShell

Este artículo afecta tanto a Office 365 Enterprise como a Microsoft 365 EnterpriseThis article applies to both Microsoft 365 Enterprise and Office 365 Enterprise.

PowerShell para Microsoft 365 le permite administrar la configuración de Microsoft 365 desde la línea de comandos.PowerShell for Microsoft 365 lets you manage your Microsoft 365 settings from the command line. Conectarse a PowerShell es un proceso sencillo que consiste en instalar el software necesario y conectarse a su organización de Microsoft 365.Connecting to PowerShell is a simple process where you install the required software and then connect to your Microsoft 365 organization.

Hay dos versiones del módulo de PowerShell que puede usar para conectarse a Microsoft 365 y administrar cuentas de usuario, grupos y licencias:There are two versions of the PowerShell module that you use to connect to Microsoft 365 and administer user accounts, groups, and licenses:

  • Azure Active Directory PowerShell para Graph (los cmdlets incluyen AzureAD en su nombre)Azure Active Directory PowerShell for Graph (cmdlets include AzureAD in their name)
  • Módulo Microsoft Azure Active Directory para Windows PowerShell (los cmdlets incluyen MSol en su nombre)Microsoft Azure Active Directory Module for Windows PowerShell (cmdlets include MSol in their name)

En la fecha de este artículo, el Módulo MAzure Active Directory para Graph no reemplaza completamente la funcionalidad de los cmdlets del Módulo Microsoft Azure Active Directory para Windows PowerShell para la administración de usuarios, grupos y licencias.As of the date of this article, the Azure Active Directory PowerShell for Graph module does not completely replace the functionality in the cmdlets of Microsoft Azure Active Directory Module for Windows PowerShell module for user, group, and license administration. En algunos casos, deberá usar ambas versiones.In some cases, you need to use both versions. Puede instalar ambas versiones de forma segura en el mismo equipo.You can safely install both versions on the same computer.

¿Qué necesita saber antes de empezar?What do you need to know before you begin?

Puede usar las siguientes versiones de Windows:You can use the following versions of Windows:

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

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

    Nota

    Para el Módulo Azure Active Directory PowerShell para Graph, debe usar la versión 5.1 o posterior de PowerShell.For the Azure Active Directory PowerShell for Graph module, you must use PowerShell version 5.1 or later. 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.For the Microsoft Azure Active Directory Module for Windows PowerShell module, you must use PowerShell version 5.1 or later up to PowerShell version 6. No puede usar la versión 7 de PowerShell.You cannot use PowerShell version 7. 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.For Windows 8.1, Windows 8, Windows 7 Service Pack 1 (SP1), Windows Server 2012 R2, Windows Server 2012, and Windows Server 2008 R2 SP1, download and install the Windows Management Framework 5.1.

    Nota

    Use una versión de 64 bits de Windows. La compatibilidad con la versión de 32 bits de Módulo de Microsoft Azure Active Directory para Windows PowerShell se descontinuó en octubre de 2014.Use a 64-bit version of Windows. Support for the 32-bit version the Microsoft Azure Active Directory Module for Windows PowerShell was discontinued in October of 2014.

Estos procedimientos están diseñados para los usuarios que sean miembros de un rol de administrador de Microsoft 365.These procedures are intended for users who are members of a Microsoft 365 admin role. Para obtener más información, vea Asignar roles de administrador.For more information, see About admin roles.

Conéctese al módulo de PowerShell de Azure Active Directory para GraphConnect with the Azure Active Directory PowerShell for Graph module

Los comandos del módulo PowerShell Azure Active Directory para Graph incluyen AzureAD en su nombre de cmdlet.Commands in the Azure Active Directory PowerShell for Graph module have AzureAD in their cmdlet name. Puede instalar el módulo Azure Active Directory PowerShell para Graph o Azure PowerShell.You can install the Azure Active Directory PowerShell for Graph module or Azure PowerShell.

Para los procedimientos que necesitan los nuevos cmdlets del módulo de PowerShell Azure Active Directory para Graph, siga estos pasos para instalar el módulo y conectarse a su suscripción a Microsoft 365.For procedures that require the new cmdlets in the Azure Active Directory PowerShell for Graph module, use these steps to install the module and connect to your Microsoft 365 subscription.

Nota

Vea Módulo de PowerShell Azure Active Directory para Graph para obtener información sobre la compatibilidad con diferentes versiones de Microsoft Windows.See Azure Active Directory PowerShell for Graph module for information about the support for different versions of Microsoft Windows.

Paso 1: Instalar el software necesarioStep 1: Install required software

Estos pasos son necesarios una sola vez en el equipo, no cada vez que se conecta. Sin embargo, probablemente necesitará instalar las versiones más recientes de software periódicamente.These steps are required once on your computer, not every time you connect. However, you'll likely need to install newer versions of the software periodically.

  1. Abra un símbolo del sistema de Windows PowerShell con privilegios elevados (ejecute Windows PowerShell como administrador).Open an elevated Windows PowerShell command prompt (run Windows PowerShell as an administrator).

  2. En la ventana de comandos Administrador: Windows PowerShell, ejecute este comando:In the Administrator: Windows PowerShell command window, run this command:

Install-Module -Name AzureAD

Si se le pregunta si quiere instalar un módulo desde un repositorio que no es de confianza, escriba Y y presione ENTRAR.If prompted about installing a module from an untrusted repository, type Y and press ENTER.

Paso 2: Conectarse a Azure AD para la suscripción de Microsoft 365Step 2: Connect to Azure AD for your Microsoft 365 subscription

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).To connect to Azure AD for your Microsoft 365 subscription with an account name and password or with multi-factor authentication (MFA), run one of these commands from a Windows PowerShell command prompt (it does not have to be elevated).

Nube de Office 365Office 365 cloud CommandCommand
Office 365 Worldwide (+GCC)Office 365 Worldwide (+GCC) Connect-AzureAD
Office 365 ofrecido por 21VianetOffice 365 operated by 21 Vianet Connect-AzureAD -AzureEnvironmentName AzureChinaCloud
Office 365 GermanyOffice 365 Germany Connect-AzureAD -AzureEnvironmentName AzureGermanyCloud
Office 365 U.S. Government DoD y Office 365 U.S. Government GCC HighOffice 365 U.S. Government DoD and Office 365 U.S. Government GCC High Connect-AzureAD -AzureEnvironmentName AzureUSGovernment

En el cuadro de diálogo Inicie sesión, escriba su nombre de usuario y contraseña de la cuenta profesional o educativa de Microsoft 365 y haga clic en Aceptar.In the Sign into your account dialog box, type your Microsoft 365 work or school account user name and password, and then click OK.

Si usa MFA, siga las instrucciones en los cuadros de diálogo adicionales para proporcionar más información de autenticación, como un código de comprobación.If you are using MFA, follow the instructions in the additional dialog boxes to provide more authentication information, such as a verification code.

Después de conectar, puede usar los cmdlets para el módulo PowerShell de Azure Active Directory para.After connecting, you can use the cmdlets for the Azure Active Directory PowerShell for Graph module.

Conectar con el Módulo Microsoft Azure Active Directory para Windows PowerShellConnect with the Microsoft Azure Active Directory Module for Windows PowerShell

Los comandos del Módulo Microsoft Azure Active Directory para Windows PowerShell tienen Msol en el nombre de su cmdlet.Commands in the Microsoft Azure Active Directory Module for Windows PowerShell have Msol in their cmdlet name.

La versión 7 de PowerShell no es compatible con el Módulo Microsoft Azure Active Directory para Windows PowerShell ni los cmdlet que llevan Msol en su nombre.PowerShell version 7 and later do not support the Microsoft Azure Active Directory Module for Windows PowerShell module and cmdlets with Msol in their name. Para la versión 7 de PowerShell y versiones posteriores, debe usar el Módulo Azure Active Directory Powershell para Graph o Azure PowerShell.For PowerShell version 7 and later, you must use the Azure Active Directory PowerShell for Graph module or Azure PowerShell.

PowerShell Core no es compatible con el Módulo Microsoft Azure Active Directory para Windows PowerShell ni los cmdlet que llevan Msol en su nombre.PowerShell Core does not support the Microsoft Azure Active Directory Module for Windows PowerShell module and cmdlets with Msol in their name. Para seguir usando estos cmdlets, debe ejecutarlos desde Windows PowerShell.To continue using these cmdlets, you must run them from Windows PowerShell.

Paso 1: Instalar el software necesarioStep 1: Install required software

Estos pasos son necesarios una sola vez en el equipo, no cada vez que se conecta. Sin embargo, probablemente necesitará instalar las versiones más recientes de software periódicamente.These steps are required once on your computer, not every time you connect. However, you'll likely need to install newer versions of the software periodically.

  1. Si no ejecuta Windows 10, instale la versión de 64 bits de Microsoft Online Services - Ayudante para el inicio de sesión: Ayudante para el inicio de sesión de Microsoft Online Services para profesionales de TI (RTW).If you are not running Windows 10, install the 64-bit version of the Microsoft Online Services Sign-in Assistant: Microsoft Online Services Sign-in Assistant for IT Professionals RTW.

  2. Instale el Módulo Microsoft Azure Active Directory para Windows PowerShell siguiendo estos pasos:Install the Microsoft Azure Active Directory Module for Windows PowerShell with these steps:

  • Abra un símbolo del sistema de Windows PowerShell con privilegios elevados (ejecute Windows PowerShell como administrador).Open an elevated Windows PowerShell command prompt (run Windows PowerShell as an administrator).
  • Ejecute el comando Install-Module MSOnline.Run the Install-Module MSOnline command.
  • Si se le pide que instale el proveedor de NuGet, escriba Y y presione ENTRAR.If prompted to install the NuGet provider, type Y and press ENTER.
  • Si se le pide que instale el módulo desde PSGallery, escriba Y y presione ENTRAR.If prompted to install the module from PSGallery, type Y and press ENTER.

Paso 2: Conectarse a Azure AD para la suscripción de Microsoft 365Step 2: Connect to Azure AD for your Microsoft 365 subscription

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).To connect to Azure AD for your Microsoft 365 subscription with an account name and password or with multi-factor authentication (MFA), run one of these commands from a Windows PowerShell command prompt (it does not have to be elevated).

Nube de Office 365Office 365 cloud CommandCommand
Office 365 Worldwide (+GCC)Office 365 Worldwide (+GCC) Connect-MsolService
Office 365 ofrecido por 21VianetOffice 365 operated by 21 Vianet Connect-MsolService -AzureEnvironment AzureChinaCloud
Office 365 GermanyOffice 365 Germany Connect-MsolService -AzureEnvironment AzureGermanyCloud
Office 365 U.S. Government DoD y Office 365 U.S. Government GCC HighOffice 365 U.S. Government DoD and Office 365 U.S. Government GCC High Connect-MsolService -AzureEnvironment USGovernment

En el cuadro de diálogo Inicie sesión, escriba su nombre de usuario y contraseña de la cuenta profesional o educativa de Microsoft 365 y haga clic en Aceptar.In the Sign into your account dialog box, type your Microsoft 365 work or school account user name and password, and then click OK.

Si usa MFA, siga las instrucciones en los cuadros de diálogo adicionales para proporcionar más información de autenticación, como un código de comprobación.If you are using MFA, follow the instructions in the additional dialog boxes to provide more authentication information, such as a verification code.

¿Cómo saber si el proceso se ha completado correctamente?How do you know this worked?

Si no se muestra ningún error, la conexión se habrá establecido correctamente.If you don't receive any errors, you connected successfully. Para hacer una prueba rápida, ejecute un cmdlet de Microsoft 365, como Get-MsolUser, y vea los resultados.A quick test is to run a Microsoft 365 cmdlet—for example, Get-MsolUser —and see the results.

Si surgen errores, compruebe los siguientes requisitos:If you receive errors, check the following requirements:

  • Un problema habitual es una contraseña incorrecta.A common problem is an incorrect password. Vuelva a realizar el paso 2.Run Step 2 again. y preste especial atención al nombre de usuario y la contraseña que escriba.and pay close attention to the user name and password you enter.

  • El Módulo de Microsoft Azure Active Directory para Windows PowerShell requiere que la característica Microsoft .NET Framework 3.5. x esté habilitada en el equipo**. Es probable que el equipo tenga instalada una versión más reciente (por ejemplo, 4 o 4.5. x), pero sea posible habilitar o deshabilitar la compatibilidad con versiones anteriores de .NET Framework. Para obtener más información al respecto, consulte los temas siguientes:The Microsoft Azure Active Directory Module for Windows PowerShell requires that the Microsoft .NET Framework 3.5. x feature is enabled on your computer**. It's likely that your computer has a newer version installed (for example, 4 or 4.5.* x*), but backwards compatibility with older versions of the .NET Framework can be enabled or disabled. For more information, see the following topics:

  • Puede que su versión de Módulo de Microsoft Azure Active Directory para Windows PowerShell esté obsoleta.Your version of the Microsoft Azure Active Directory Module for Windows PowerShell might be out of date. Para comprobarlo, ejecute el siguiente comando en PowerShell para Microsoft 365 o el Módulo de Microsoft Azure Active Directory para Windows PowerShell:To check, run the following command in PowerShell for Microsoft 365 or the Microsoft Azure Active Directory Module for 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 el valor 1.0.8070.2, desinstale el Módulo de Microsoft Azure Active Directory para Windows PowerShell e instale de nuevo siguiendo el Paso 1, que encontrará arriba.If the version number returned is lower than the value 1.0.8070.2, uninstall the Microsoft Azure Active Directory Module for Windows PowerShell and install from Step 1 above.

  • Si recibe un error de conexión, vea este tema: Error “Connect-MsolService: Se produjo una excepción de tipo”.If you receive a connection error, see this topic: "Connect-MsolService: Exception of type was thrown" error.

  • Si recibe un mensaje de error "Obtener elemento: No se encontró la ruta de acceso", utilice este comando:If you receive a "Get-Item : Cannot find path" error, use this command:

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

Consulte tambiénSee also