Delen via


Add-AzureAccount

Voegt het Azure-account toe aan Windows PowerShell.

Notitie

De cmdlets waarnaar in deze documentatie wordt verwezen, zijn bedoeld voor het beheren van verouderde Azure-resources die gebruikmaken van ASM-API's (Azure Service Manager). Deze verouderde PowerShell-module wordt niet aanbevolen bij het maken van nieuwe resources, omdat ASM is gepland voor buitengebruikstelling. Zie Buitengebruikstelling van Azure Service Manager voor meer informatie.

De Az PowerShell-module is de aanbevolen PowerShell-module voor het beheren van ARM-resources (Azure Resource Manager) met PowerShell.

Syntaxis

Add-AzureAccount
   [-Environment <String>]
   [-Credential <PSCredential>]
   [-Tenant <String>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
Add-AzureAccount
   [-Environment <String>]
   -Credential <PSCredential>
   [-ServicePrincipal]
   -Tenant <String>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

De cmdlet Add-AzureAccount maakt uw Azure-account en de bijbehorende abonnementen beschikbaar in Windows PowerShell. Het is net als aanmelden bij uw Azure-account in Windows PowerShell. Gebruik de cmdlet Remove-AzureAccount om u af te melden bij het account.

Add-AzureAccount downloadt informatie over uw Azure-account en slaat deze op in een abonnementsgegevensbestand in uw zwervende gebruikersprofiel. Het krijgt ook een toegangstoken waarmee Windows PowerShell namens u toegang heeft tot uw Azure-account. Wanneer de opdracht is voltooid, kunt u uw Azure-account beheren in Windows PowerShell.

Er zijn twee verschillende manieren om uw Azure-account beschikbaar te maken voor Windows PowerShell. U kunt de cmdlet Add-AzureAccount gebruiken, die gebruikmaakt van Toegangstokens voor Microsoft Entra-verificatie of Import-AzurePublishSettingsFile, dat gebruikmaakt van een beheercertificaat. Zie How to: Connect to your subscription () (Verbinding maken met uw abonnement)https://azure.microsoft.com/documentation/articles/install-configure-powershell/#Connect voor hulp bij welke methode u moet gebruiken.

Wanneer u Add-AzureAccount uitvoert, wordt er een interactief venster weergegeven waarin u wordt gevraagd u aan te melden bij uw Azure-account. Deze aanmelding is geldig totdat het toegangstoken verloopt. Wanneer deze verloopt, wordt u gevraagd om add-AzureAccount opnieuw uit te voeren voor cmdlets waarvoor toegang tot uw account is vereist.

In dit onderwerp wordt de cmdlet in de versie 0.8.10 van de Microsoft Azure PowerShell-module beschreven. Als u de versie van de module wilt ophalen die u gebruikt, typt (Get-Module -Name Azure).Versionu in de Azure PowerShell-console.

Voorbeelden

Voorbeeld 1: Een account toevoegen

PS C:\> Add-AzureAccount

Met deze opdracht wordt een Azure-account toegevoegd aan Windows PowerShell. Wanneer u de opdracht uitvoert, wordt er een venster weergegeven om de gebruikersnaam en het wachtwoord van het account aan te vragen.

Voorbeeld 2: Een alternatief abonnementsgegevensbestand gebruiken

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

Met deze opdracht wordt de parameter SubscriptionDataFile gebruikt om Add-AzureAccount om de accountgegevens in het bestand C:\Testing\SDF.xml op te slaan in plaats van het standaardbestand.

Parameters

-Credential

Type:PSCredential
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Environment

Hiermee geeft u een Azure-omgeving op.

Een Azure-omgeving een onafhankelijke implementatie van Microsoft Azure, zoals AzureCloud voor wereldwijde Azure en AzureChinaCloud voor Azure beheerd door 21Vianet in China. U kunt ook on-premises Azure-omgevingen maken met behulp van Azure Pack en de WAPack-cmdlets. Zie Azure Pack voor meer informatie.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Profile

Hiermee geeft u het Azure-profiel op waaruit deze cmdlet wordt gelezen. Als u geen profiel opgeeft, leest deze cmdlet uit het lokale standaardprofiel.

Type:AzureSMProfile
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ServicePrincipal

Type:SwitchParameter
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Tenant

Type:String
Aliassen:TenantId
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

None

U kunt geen invoer doorsluisen naar deze cmdlet

Uitvoerwaarden

None

Deze cmdlet retourneert geen uitvoer.

Notities

  • Add-AzureAccount (en de verificatiemethode Microsoft Entra) heeft voorrang op Import-AzurePublishSettings (en de beheercertificaatmethode). Als u Add-AzureAccount zelfs eenmaal op uw account gebruikt, wordt de verificatiemethode Microsoft Entra gebruikt en wordt het beheercertificaat genegeerd. Gebruik de cmdlet Remove-AzureAccount om het Microsoft Entra-token te verwijderen en de beheercertificaatmethode te herstellen. Voor meer informatie typt u: Get-Help Remove-AzureAccount.
  • De fout 'Uw referenties zijn verlopen. Gebruik Add-AzureAccount om u opnieuw aan te melden.' Geeft aan dat uw toegangstoken is verlopen en Windows PowerShell geen toegang heeft tot uw Azure-account. Als u de toegang tot uw account wilt herstellen, voert u Add-AzureAccount opnieuw uit.
  • De Azure PowerShell-account- en abonnements-cmdlets halen hun gegevens op uit het abonnementsgegevensbestand, niet uit het live Azure-account. Als u uw account of abonnementen buiten Windows PowerShell wijzigt, bijvoorbeeld met behulp van de Azure-beheerportal, voert u Add-AzureAccount opnieuw uit om het abonnementsgegevensbestand te vernieuwen.