Add-AzureRmAccount

Referencia

Módulo:: AzureRM.Profile

Agrega una cuenta autenticada para utilizarla con las solicitudes de cmdlet de Azure Resource Manager.

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-AzureRmAccount
   [-Environment <String>]
   [[-Credential] <PSCredential>]
   [-TenantId <String>]
   [-SubscriptionId <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-AzureRmAccount
   [-Environment <String>]
   [[-Credential] <PSCredential>]
   [-TenantId <String>]
   -SubscriptionName <String>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-AzureRmAccount
   [-Environment <String>]
   [-Credential] <PSCredential>
   [-ServicePrincipal]
   -TenantId <String>
   [-SubscriptionId <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-AzureRmAccount
   [-Environment <String>]
   [-Credential] <PSCredential>
   [-ServicePrincipal]
   -TenantId <String>
   -SubscriptionName <String>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-AzureRmAccount
   [-Environment <String>]
   -CertificateThumbprint <String>
   -ApplicationId <String>
   [-ServicePrincipal]
   -TenantId <String>
   [-SubscriptionId <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-AzureRmAccount
   [-Environment <String>]
   -CertificateThumbprint <String>
   -ApplicationId <String>
   [-ServicePrincipal]
   -TenantId <String>
   -SubscriptionName <String>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-AzureRmAccount
   [-Environment <String>]
   [-TenantId <String>]
   -AccessToken <String>
   -AccountId <String>
   [-SubscriptionId <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-AzureRmAccount
   [-Environment <String>]
   [-TenantId <String>]
   -AccessToken <String>
   -AccountId <String>
   -SubscriptionName <String>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet Add-AzureRmAcccount agrega una cuenta de Azure autenticada que se usará para las solicitudes de cmdlet de Azure Resource Manager.

Puede usar esta cuenta autenticada solo con cmdlets de Azure Resource Manager. Para agregar una cuenta autenticada para su uso con cmdlets de Service Management, use add-AzureAccount o el cmdlet Import-AzurePublishSettingsFile.

Ejemplos

Ejemplo 1: Agregar una cuenta que requiera inicio de sesión interactivo

PS C:\>Add-AzureRmAccount
Account: azureuser@contoso.com
Environment: AzureCloud
Subscription: xxxx-xxxx-xxxx-xxxx
Tenant: xxxx-xxxx-xxxx-xxxx

Este comando agrega una cuenta de Azure Resource Manager.

Para ejecutar cmdlets de Azure Resource Manager con esta cuenta, debe proporcionar credenciales de identificador de organización o cuenta microsoft en el símbolo del sistema.

Si la autenticación multifactor está habilitada para las credenciales, debe iniciar sesión con la opción interactiva o usar la autenticación de entidad de servicio.

Ejemplo 2: Adición de una cuenta que se autentica con credenciales de identificador de organización

PS C:\>$Credential = Get-Credential
PS C:\> Add-AzureRmAccount -Credential $Credential
Account: azureuser@contoso.com
Environment: AzureChinaCloud
Subscription: xxxx-xxxx-xxxx-xxxx
Tenant: xxxx-xxxx-xxxx-xxxx

El primer comando obtiene las credenciales de usuario y, a continuación, los almacena en la variable $Credential.

El segundo comando agrega una cuenta de Azure Resource Manager con las credenciales de $Credential.

Esta cuenta se autentica con Azure Resource Manager mediante credenciales de identificador de organización. No puede usar la autenticación multifactor ni las credenciales de la cuenta Microsoft para ejecutar cmdlets de Azure Resource Manager con esta cuenta.

Ejemplo 3: Adición de una cuenta que se autentica con credenciales de entidad de servicio

PS C:\>$Credential = Get-Credential
PS C:\> Add-AzureRmAccount -Credential $Credential -Tenant "xxxx-xxxx-xxxx-xxxx" -ServicePrincipal
Account: xxxx-xxxx-xxxx-xxxx
Environment: AzureCloud
Subscription: yyyy-yyyy-yyyy-yyyy
Tenant: xxxx-xxxx-xxxx-xxxx

El primer comando obtiene las credenciales de usuario y, a continuación, los almacena en la variable $Credential.

El segundo comando agrega una cuenta de Azure Resource Manager con las credenciales almacenadas en $Credential para el inquilino especificado. El parámetro del modificador ServicePrincipal indica que la cuenta se autentica como una entidad de servicio.

Ejemplo 4: Agregar una cuenta para un inquilino y una suscripción específicos

PS C:\>Add-AzureRmAccount -Tenant "xxxx-xxxx-xxxx-xxxx" -SubscriptionId "yyyy-yyyy-yyyy-yyyy"
Account: pfuller@contoso.com
Environment: AzureCloud
Subscription: yyyy-yyyy-yyyy-yyyy
Tenant: xxxx-xxxx-xxxx-xxxx

Este comando agrega una cuenta de Azure Resource Manager para ejecutar cmdlets para el inquilino y la suscripción especificados de forma predeterminada.

Parámetros

-AccessToken

Especifica un token de acceso.

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

-AccountId

Identificador de cuenta para el token de acceso

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

-ApplicationId

SPN

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

-CertificateThumbprint

Hash de certificado (huella digital)

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

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

Especifica un objeto PSCredential. Para obtener más información sobre el objeto PSCredential, escriba Get-Help Get-Credential.

El objeto PSCredential proporciona el identificador de usuario y la contraseña para las credenciales de identificador de la organización, o el identificador de aplicación y el secreto para las credenciales de la entidad de servicio.

Type:	PSCredential
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Environment

Entorno que contiene la cuenta en la que iniciar sesión

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

-ServicePrincipal

Indica que esta cuenta se autentica proporcionando credenciales de entidad de servicio.

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

-SubscriptionId

Especifica el identificador de la suscripción. Si no especifica este parámetro, se usa la primera suscripción de la lista de suscripciones.

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

-SubscriptionName

Nombre de suscripción

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

-TenantId

Identificador o nombre de inquilino opcional

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

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Salidas

PSAzureProfile