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 de Azure heredados que usan Service Management API. Consulte el módulo de Az PowerShell para cmdlets para administrar recursos de Azure Resource Manager.

Syntax

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-AzurePublish Configuración File, que usa un certificado de administración. Para obtener instrucciones sobre qué método usar, consulte How to: Conectar 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

Type:PSCredential
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Profile

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

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServicePrincipal

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Tenant

Type:String
Aliases:TenantId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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-AzurePublish Configuración (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.