Add-AzureAccount

  • Referenz
Modul:
Azure

Fügt das Azure-Konto zu Windows PowerShell hinzu.

Hinweis

Die in dieser Dokumentation referenzierten Cmdlets dienen zum Verwalten von älteren Azure-Ressourcen, die Azure Service Manager (ASM)-APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit 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>]

Beschreibung

Das Add-AzureAccount-Cmdlet stellt Ihr Azure-Konto und seine Abonnements in Windows PowerShell zur Verfügung. Es ist wie die Anmeldung bei Ihrem Azure-Konto in Windows PowerShell. Um sich vom Konto abzumelden, verwenden Sie das Cmdlet Remove-AzureAccount .

Add-AzureAccount lädt Informationen zu Ihrem Azure-Konto herunter und speichert sie in einer Abonnementdatendatei in Ihrem Roamingbenutzerprofil. Außerdem wird ein Zugriffstoken abgerufen, mit dem Windows PowerShell in Ihrem Auftrag auf Ihr Azure-Konto zugreifen kann. Nach Abschluss des Befehls können Sie Ihr Azure-Konto in Windows PowerShell verwalten.

Es gibt zwei verschiedene Möglichkeiten, Ihr Azure-Konto für Windows PowerShell verfügbar zu machen. Sie können das Add-AzureAccount-Cmdlet verwenden, das Microsoft Entra-Authentifizierungszugriffstoken verwendet, oder Import-AzurePublishSettingsFile, das ein Verwaltungszertifikat verwendet. Anleitungen zu der zu verwendenden Methode finden Sie unter How to: Connect to your subscription (https://azure.microsoft.com/documentation/articles/install-configure-powershell/#Connect).

Wenn Sie Add-AzureAccount ausführen, wird ein interaktives Fenster angezeigt, in dem Sie aufgefordert werden, sich bei Ihrem Azure-Konto anzumelden. Diese Anmeldung ist gültig, bis das Zugriffstoken abläuft. Wenn es abläuft, werden Cmdlets, die Zugriff auf Ihr Konto erfordern, aufgefordert, Add-AzureAccount erneut auszuführen.

In diesem Thema wird das Cmdlet in der Version 0.8.10 des Microsoft Azure PowerShell-Moduls beschrieben. Um die Version des verwendeten Moduls abzurufen, geben Sie in der Azure PowerShell-Konsole folgendes ein (Get-Module -Name Azure).Version.

Beispiele

Beispiel 1: Hinzufügen eines Kontos

PS C:\> Add-AzureAccount

Mit diesem Befehl wird windows PowerShell ein Azure-Konto hinzugefügt. Wenn Sie den Befehl ausführen, wird ein Fenster angezeigt, um den Benutzernamen und das Kennwort des Kontos anzufordern.

Beispiel 2: Verwenden einer alternativen Abonnementdatendatei

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

Dieser Befehl verwendet den Parameter "SubscriptionDataFile", um Add-AzureAccount zu leiten, um die Kontodaten in der Datei "C:\Testing\SDF.xml" anstelle der Standarddatei zu speichern.

Parameter

-Credential

Typ:PSCredential
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Environment

Gibt eine Azure-Umgebung an.

Eine Azure-Umgebung eine unabhängige Bereitstellung von Microsoft Azure, z. B. AzureCloud für globale Azure und AzureChinaCloud für Azure, betrieben von 21Vianet in China. Sie können auch lokale Azure-Umgebungen mithilfe von Azure Pack und den WAPack-Cmdlets erstellen. Weitere Informationen finden Sie unter Azure Pack.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Profile

Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.

Typ:AzureSMProfile
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ServicePrincipal

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Tenant

Typ:String
Aliase:TenantId
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Sie können keine Eingabe an dieses Cmdlet weiterleiten.

Ausgaben

None

Dieses Cmdlet gibt keine Ausgabe zurück.

Hinweise

  • Add-AzureAccount (und die Microsoft Entra-Authentifizierungsmethode) hat Vorrang vor Import-AzurePublishSettings (und der Verwaltungszertifikatmethode). Wenn Sie Add-AzureAccount sogar einmal auf Ihrem Konto verwenden, wird die Microsoft Entra-Authentifizierungsmethode verwendet, und das Verwaltungszertifikat wird ignoriert. Verwenden Sie das Cmdlet Remove-AzureAccount, um das Microsoft Entra-Token zu entfernen und die Verwaltungszertifikatmethode wiederherzustellen. Weitere Informationen finden Sie unter: Get-Help Remove-AzureAccount.
  • Der Fehler "Ihre Anmeldeinformationen sind abgelaufen. Verwenden Sie "Add-AzureAccount", um sich erneut anzumelden." gibt an, dass Ihr Zugriffstoken abgelaufen ist und Windows PowerShell nicht auf Ihr Azure-Konto zugreifen kann. Um den Zugriff auf Ihr Konto wiederherzustellen, führen Sie "Add-AzureAccount" erneut aus.
  • Das Azure PowerShell-Konto und die Abonnement-Cmdlets erhalten ihre Daten aus der Abonnementdatendatei, nicht aus dem Live-Azure-Konto. Wenn Sie Ihr Konto oder Ihre Abonnements außerhalb von Windows PowerShell ändern, z. B. mithilfe des Azure-Verwaltungsportals, führen Sie Add-AzureAccount erneut aus, um die Abonnementdatendatei zu aktualisieren.