Dela via

Add-AzureAccount

  • Referens
Modul:
Azure

Lägger till Azure-kontot i Windows PowerShell.

Kommentar

De cmdletar som refereras i den här dokumentationen används för att hantera äldre Azure-resurser som använder API:er för Azure Service Manager (ASM). Den här äldre PowerShell-modulen rekommenderas inte när du skapar nya resurser eftersom ASM är schemalagt för tillbakadragning. Mer information finns i Azure Service Manager-tillbakadragning.

Az PowerShell-modulen är den rekommenderade PowerShell-modulen för hantering av Arm-resurser (Azure Resource Manager) med PowerShell.

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

Cmdleten Add-AzureAccount gör ditt Azure-konto och dess prenumerationer tillgängliga i Windows PowerShell. Det är som att logga in på ditt Azure-konto i Windows PowerShell. Om du vill logga ut från kontot använder du cmdleten Remove-AzureAccount .

Add-AzureAccount laddar ned information om ditt Azure-konto och sparar den i en prenumerationsdatafil i din centrala användarprofil. Den hämtar också en åtkomsttoken som gör att Windows PowerShell kan komma åt ditt Azure-konto åt dig. När kommandot har slutförts kan du hantera ditt Azure-konto i Windows PowerShell.

Det finns två olika sätt att göra ditt Azure-konto tillgängligt för Windows PowerShell. Du kan använda cmdleten Add-AzureAccount , som använder åtkomsttoken för Microsoft Entra-autentisering, eller Import-AzurePublishSettingsFile, som använder ett hanteringscertifikat. Vägledning om vilken metod som ska användas finns i Så här ansluter du till din prenumeration (https://azure.microsoft.com/documentation/articles/install-configure-powershell/#Connect).

När du kör Add-AzureAccount visas ett interaktivt fönster som uppmanar dig att logga in på ditt Azure-konto. Den här inloggningen är giltig tills åtkomsttoken upphör att gälla. När den upphör att gälla uppmanar cmdletar som kräver åtkomst till ditt konto dig att köra Add-AzureAccount igen.

Det här avsnittet beskriver cmdleten i 0.8.10-versionen av Microsoft Azure PowerShell-modulen. Om du vill hämta den version av modulen som du använder skriver (Get-Module -Name Azure).Versiondu i Azure PowerShell-konsolen .

Exempel

Exempel 1: Lägg till ett konto

PS C:\> Add-AzureAccount

Det här kommandot lägger till ett Azure-konto i Windows PowerShell. När du kör kommandot visas ett fönster för att begära användarkontots användarnamn och lösenord.

Exempel 2: Använd en alternativ prenumerationsdatafil

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

Det här kommandot använder parametern SubscriptionDataFile för att dirigera Add-AzureAccount för att lagra kontodata i filen C:\Testing\SDF.xml i stället för standardfilen.

Parametrar

-Credential

Typ:PSCredential
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Environment

Anger en Azure-miljö.

En Azure-miljö en oberoende distribution av Microsoft Azure, till exempel AzureCloud för globala Azure och AzureChinaCloud för Azure som drivs av 21Vianet i Kina. Du kan också skapa lokala Azure-miljöer med hjälp av Azure Pack och WAPack-cmdletarna. Mer information finns i Azure Pack.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Profile

Anger den Azure-profil som den här cmdleten läser från. Om du inte anger någon profil läser den här cmdleten från den lokala standardprofilen.

Typ:AzureSMProfile
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ServicePrincipal

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Tenant

Typ:String
Alias:TenantId
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

None

Du kan inte skicka indata till den här cmdleten

Utdata

None

Den här cmdleten returnerar inga utdata.

Kommentarer

  • Add-AzureAccount (och Microsoft Entra-autentiseringsmetoden) har företräde framför Import-AzurePublishSettings (och hanteringscertifikatmetoden ). Om du använder Add-AzureAccount även en gång på ditt konto används Microsoft Entra-autentiseringsmetoden och hanteringscertifikatet ignoreras. Om du vill ta bort Microsoft Entra-token och återställa hanteringscertifikatmetoden använder du cmdleten Remove-AzureAccount . Mer information finns i: Get-Help Remove-AzureAccount.
  • Felet "Dina autentiseringsuppgifter har upphört att gälla. Använd Add-AzureAccount för att logga in igen." anger att din åtkomsttoken har upphört att gälla och att Windows PowerShell inte kan komma åt ditt Azure-konto. Om du vill återställa åtkomsten till ditt konto kör du Add-AzureAccount igen.
  • Azure PowerShell-konto- och prenumerations-cmdletar hämtar sina data från prenumerationsdatafilen, inte från live-Azure-kontot. Om du ändrar ditt konto eller prenumerationer utanför Windows PowerShell, till exempel genom att använda Azure Management Portal, kör du Add-AzureAccount igen för att uppdatera prenumerationsdatafilen.