Add-AzureAccount
Fügt das Azure-Konto zu Windows PowerShell hinzu.
Hinweis
Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-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
User (Standardwert)
Add-AzureAccount
[-Environment <String>]
[-Credential <PSCredential>]
[-Tenant <String>]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
ServicePrincipal
Add-AzureAccount
-Credential <PSCredential>
-Tenant <String>
[-Environment <String>]
[-ServicePrincipal]
[-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.
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
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.
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.
Parametereigenschaften
| Typ: | PSCredential |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
User
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Profile
Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.
Parametereigenschaften
| Typ: | AzureSMProfile |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ServicePrincipal
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.
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.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ServicePrincipal
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Tenant
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.
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.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Mieter-ID |
Parametersätze
User
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
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.