Add-AzureAccount

  • Referencia
Módulo:
Azure

Agrega la cuenta de Azure a Windows PowerShell.

Nota:

Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos heredados de Azure que usan las API de Azure Service Manager (ASM). Este módulo heredado de PowerShell no se recomienda al crear nuevos recursos, ya que ASM está programado para la retirada. Para más información, consulte Retirada de Azure Service Manager.

El módulo Az powerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.

Sintaxis

Add-AzureAccount
   [-Environment <String>]
   [-Credential <PSCredential>]
   [-Tenant <String>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
Add-AzureAccount
   [-Environment <String>]
   -Credential <PSCredential>
   [-ServicePrincipal]
   -Tenant <String>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

El cmdlet Add-AzureAccount hace que la cuenta de Azure y sus suscripciones estén disponibles en Windows PowerShell. Es como iniciar sesión en su cuenta de Azure en Windows PowerShell. Para cerrar la sesión de la cuenta, use el cmdlet Remove-AzureAccount .

Add-AzureAccount descarga información sobre su cuenta de Azure y la guarda en un archivo de datos de suscripción en el perfil de usuario móvil. También obtiene un token de acceso que permite a Windows PowerShell acceder a su cuenta de Azure en su nombre. Cuando se complete el comando, puede administrar la cuenta de Azure en Windows PowerShell.

Hay dos maneras diferentes de hacer que la cuenta de Azure esté disponible para Windows PowerShell. Puede usar el cmdlet Add-AzureAccount , que usa tokens de acceso de autenticación de Microsoft Entra o Import-AzurePublishSettingsFile, que usa un certificado de administración. Para obtener instrucciones sobre qué método usar, consulte How to: Connect to your subscription (https://azure.microsoft.com/documentation/articles/install-configure-powershell/#Connect).

Al ejecutar Add-AzureAccount, muestra una ventana interactiva que le pide que inicie sesión en su cuenta de Azure. Este inicio de sesión es válido hasta que expire el token de acceso. Cuando expire, los cmdlets que requieren acceso a su cuenta le pedirán que vuelva a ejecutar Add-AzureAccount .

En este tema se describe el cmdlet en la versión 0.8.10 del módulo de Microsoft Azure PowerShell. Para obtener la versión del módulo que usa, en la consola de Azure PowerShell, escriba (Get-Module -Name Azure).Version.

Ejemplos

Ejemplo 1: Agregar una cuenta

PS C:\> Add-AzureAccount

Este comando agrega una cuenta de Azure a Windows PowerShell. Al ejecutar el comando, aparece una ventana para solicitar el nombre de usuario y la contraseña de la cuenta.

Ejemplo 2: Uso de un archivo de datos de suscripción alternativo

PS C:\> Add-AzureAccount -SubscriptionDataFile C:\Testing\SDF.xml

Este comando usa el parámetro SubscriptionDataFile para dirigir Add-AzureAccount para almacenar los datos de la cuenta en el archivo C:\Testing\SDF.xml, en lugar del archivo predeterminado.

Parámetros

-Credential

Tipo:PSCredential
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Environment

Especifica un entorno de Azure.

Un entorno de Azure que es una implementación independiente de Microsoft Azure, como AzureCloud para Azure global y AzureChinaCloud para Azure operado por 21Vianet en China. También puede crear entornos de Azure locales mediante Azure Pack y los cmdlets WAPack. Para más información, consulte Azure Pack.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Profile

Especifica el perfil de Azure del que lee este cmdlet. Si no especifica un perfil, este cmdlet lee del perfil predeterminado local.

Tipo:AzureSMProfile
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ServicePrincipal

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Tenant

Tipo:String
Alias:TenantId
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

None

No se puede canalizar la entrada a este cmdlet

Salidas

None

Este cmdlet no genera resultados de ningún tipo.

Notas

  • Add-AzureAccount (y el método de autenticación Microsoft Entra) tiene prioridad sobre Import-AzurePublishSettings (y el método de certificado de administración). Si usa Add-AzureAccount incluso una vez en su cuenta, se usa el método de autenticación Microsoft Entra y se omite el certificado de administración. Para quitar el token de Microsoft Entra y restaurar el método de certificado de administración, use el cmdlet Remove-AzureAccount . Para más información, escriba: Get-Help Remove-AzureAccount.
  • Error: "Las credenciales han expirado. Use Add-AzureAccount para iniciar sesión de nuevo". indica que el token de acceso ha expirado y Windows PowerShell no puede acceder a su cuenta de Azure. Para restaurar el acceso a la cuenta, vuelva a ejecutar Add-AzureAccount .
  • Los cmdlets de suscripción y cuenta de Azure PowerShell obtienen sus datos del archivo de datos de suscripción, no de la cuenta de Azure activa. Si cambia su cuenta o suscripciones fuera de Windows PowerShell, como mediante el Portal de administración de Azure, vuelva a ejecutar Add-AzureAccount para actualizar el archivo de datos de suscripción.