Compartir a través de


Inicio de sesión interactivo en Azure PowerShell

Los inicios de sesión interactivos en Azure ofrecen una experiencia de usuario más intuitiva y flexible. El inicio de sesión interactivo con Azure PowerShell permite a los usuarios autenticarse directamente en Azure mediante la interfaz de PowerShell, lo que resulta útil para las tareas de administración ad hoc y para entornos que requieren un inicio de sesión manual, como los que tienen autenticación multifactor (MFA). Este método simplifica el acceso a las pruebas de scripts, el aprendizaje y la administración sobre la marcha sin necesidad de configurar previamente las entidades de servicio u otros métodos de autenticación no interactivos.

Requisitos previos

Inicio de sesión interactivo

Para iniciar sesión de forma interactiva, use el cmdlet Connect-AzAccount. A partir de la versión 12.0.0 del módulo Az PowerShell, los sistemas Windows usan el Administrador de cuentas web (WAM), mientras que los sistemas Linux y macOS usan el inicio de sesión basado en explorador de manera predeterminada.

Connect-AzAccount

Experiencia de inicio de sesión

A partir de la versión 12.0.0 del módulo Az PowerShell, si tiene acceso a varias suscripciones de Azure, se le pedirá que seleccione aquella con la que quiere iniciar sesión, como se muestra en el siguiente ejemplo.

Please select the account you want to login with.

Retrieving subscriptions for the selection...
WARNING: To override which subscription Connect-AzAccount selects by default, use
`Update-AzConfig -DefaultSubscriptionForLogin 00000000-0000-0000-0000-000000000000`.
Go to https://go.microsoft.com/fwlink/?linkid=2200610 for more information.
[Tenant and subscription selection]

No    Subscription name                     Subscription ID                           Tenant name
----  ------------------------------------  ----------------------------------------  --------------
[1]   Facility Services Subscription        00000000-0000-0000-0000-000000000000      Contoso
[2]   Finance Department Subscription       00000000-0000-0000-0000-000000000000      Contoso
[3]   Human Resources Subscription          00000000-0000-0000-0000-000000000000      Contoso
[4]   Information Technology Subscription   00000000-0000-0000-0000-000000000000      Contoso

Select a tenant and subscription: 2

Subscription name                       Tenant name
------------------------------------    --------------------------
Finance Department Subscription         Contoso

[Announcements]
With the new Azure PowerShell login experience, you can select the subscription you want to use more easily.
Learn more about it and its configuration at https://go.microsoft.com/fwlink/?linkid=2271236.
Share your feedback regarding your experience with `Connect-AzAccount` at: https://aka.ms/azloginfeedback

If you encounter any problem, please open an issue at: https://aka.ms/azpsissue

Subscription name                      Tenant
-----------------                      ------
Finance Department Subscription        Contoso

La próxima vez que inicie sesión, el inquilino y la suscripción seleccionados anteriormente se marcan como el valor predeterminado con un asterisco (*) junto a su número y se resaltan en color azul cian. Esto le permite presionar Entrar para seleccionar el valor predeterminado o escribir un número para seleccionar un inquilino y una suscripción diferentes.

No    Subscription name                     Subscription ID                           Tenant name
----  ------------------------------------  ----------------------------------------  --------------
[1]   Facility Services Subscription        00000000-0000-0000-0000-000000000000      Contoso
[2] * Finance Department Subscription       00000000-0000-0000-0000-000000000000      Contoso
[3]   Human Resources Subscription          00000000-0000-0000-0000-000000000000      Contoso
[4]   Information Technology Subscription   00000000-0000-0000-0000-000000000000      Contoso

The default is marked with an *; the default tenant is 'Contoso' and subscription is
'Finance Department Subscription (00000000-0000-0000-0000-000000000000)'.

Select a tenant and subscription (type a number or Enter to accept default): 4

Subscription name                       Tenant name
------------------------------------    --------------------------
Information Technology Subscription     Contoso

Los comandos se ejecutan en esta suscripción de forma predeterminada. Para cambiar la suscripción activa, use el cmdlet Set-AzContext. Para más información, consulte Objetos de contexto de Azure PowerShell.

Configuración de la suscripción predeterminada para el inicio de sesión

Para evitar que se le pida que seleccione una suscripción cada vez que inicie sesión de forma interactiva, use el cmdlet Update-AzConfig para configurar la suscripción predeterminada, como se muestra en el ejemplo siguiente.

Update-AzConfig -DefaultSubscriptionForLogin '<subscription name or id>'

Deshabilitación de la nueva experiencia de inicio de sesión

Para deshabilitar la nueva experiencia de inicio de sesión, use el cmdlet Update-AzConfig, como se muestra en el siguiente ejemplo.

Update-AzConfig -LoginExperienceV2 Off

Se inicia sesión en la primera suscripción que Azure devuelve si tiene acceso a más de una suscripción y la nueva experiencia de inicio de sesión está deshabilitada. Los comandos se ejecutan en esta suscripción de forma predeterminada. Para cambiar la suscripción activa dea sesión, use el cmdlet de Set-AzContext. Para cambiar la suscripción activa y hacer que persista entre las sesiones en el mismo sistema, use el cmdlet de Select-AzContext.

Administrador de cuentas web (WAM)

A partir de la versión 12.0.0 del módulo Az PowerShell, el método de autenticación de inicio de sesión predeterminado de Azure PowerShell para sistemas basados en Windows es Administrador de cuentas web (WAM).

WAM es un componente Windows 10+ que actúa como agente de autenticación. Un agente de autenticación es una aplicación que se ejecuta en su sistema y que administra los protocolos de enlace de autenticación y el mantenimiento de tokens para las cuentas conectadas.

Ventajas de WAM

El uso de WAM tiene varias ventajas:

Limitaciones de WAM

En la fase actual de desarrollo, WAM presenta algunas limitaciones conocidas:

  • WAM está disponible en Windows 10 y versiones posteriores y en Windows Server 2019 y versiones posteriores. En Linux, macOS y versiones anteriores de Windows, Azure PowerShell tiene automáticamente como valor predeterminado el inicio de sesión basado en explorador.

  • Actualmente no se admite el uso de WAM para iniciar sesión en nubes nacionales.

  • Las cuentas Microsoft (por ejemplo, @outlook.com o @live.com) deben especificar el parámetro Tenant cuando se usan con MFA.

    Connect-AzAccount -Tenant 00000000-0000-0000-0000-000000000000
    

Deshabilitación de WAM

Para usar el inicio de sesión basado en explorador en Windows 10 y versiones posteriores o en Windows Server 2019 y versiones posteriores con Az 12.0.0 y versiones posteriores, debe deshabilitar WAM para su uso con Azure PowerShell. Use el siguiente comando para deshabilitar WAM y volver al inicio de sesión basado en explorador, el valor predeterminado antes de Az 12.0.0.

Update-AzConfig -EnableLoginByWam $false

Inicio de sesión basado en explorador

El inicio de sesión basado en explorador es el inicio de sesión interactivo predeterminado para sistemas Linux, macOS y Windows anteriores a Windows 10 o Windows Server 2019. A partir de la versión 12.0.0 del módulo Az PowerShell, debe deshabilitar WAM para Azure PowerShell para poder usar el inicio de sesión basado en explorador en sistemas basados en Windows, que era el valor predeterminado antes de Az 12.0.0.

Al iniciar sesión de forma interactiva con el cmdlet Connect-AzAccount, el inicio de sesión basado en explorador abre el explorador web predeterminado para cargar una página de inicio de sesión de Azure. Inicie sesión con las credenciales de su cuenta de Azure en el explorador.

Si Azure PowerShell puede abrir el explorador predeterminado, se inicia el flujo de código de autorización y se abre el explorador predeterminado para cargar una página de inicio de sesión de Azure. De lo contrario, se inicia el flujo de código de dispositivo, que le indica que abra una página del explorador en microsoft.com/devicelogin y escriba el código que se muestra en la sesión de PowerShell.

Autenticación con código de dispositivo

Si el Administrador de cuentas web o un explorador web no están disponibles o no se pueden abrir, puede forzar el flujo de código del dispositivo especificando el parámetro UseDeviceAuthentication.

Connect-AzAccount -UseDeviceAuthentication

Inicio de sesión con otro inquilino

Si su cuenta está asociada con más de un inquilino, para iniciar sesión es necesario especificar el parámetro Tenant al conectarse. Este parámetro funciona con cualquier método de inicio de sesión. Al iniciar sesión, el valor de este parámetro puede ser el identificador de objeto del inquilino de Azure (Id. de inquilino) o el nombre de dominio completo del inquilino.

Connect-AzAccount -Tenant 00000000-0000-0000-0000-000000000000

Inicio de sesión en una nube nacional

Las nubes nacionales (también conocidas como nubes soberanas) son instancias físicamente aisladas de Azure diseñadas para garantizar que se respetan los requisitos de residencia de datos, soberanía y cumplimiento dentro de los límites geográficos. Para las cuentas en una nube nacional, establezca el entorno al iniciar sesión con el parámetro Entorno. Este parámetro funciona con cualquier método de inicio de sesión. Por ejemplo, si su cuenta está en Azure China 21Vianet, use el siguiente comando:

Connect-AzAccount -Environment AzureChinaCloud

Ejecute el comando siguiente para obtener una lista de los entornos de nube nacionales disponibles:

Get-AzEnvironment | Select-Object -Property Name

Consulte también