Sdílet prostřednictvím

Add-AzureAccount

  • Reference
Modul:
Azure

Přidá účet Azure do Prostředí Windows PowerShell.

Poznámka:

Rutiny, na které odkazuje tato dokumentace, slouží ke správě starších prostředků Azure, které používají rozhraní API Azure Service Manageru (ASM). Tento starší modul PowerShellu se nedoporučuje při vytváření nových prostředků, protože ASM je naplánované pro vyřazení z provozu. Další informace najdete v části Vyřazení Azure Service Manageru.

Modul Az PowerShell je doporučený modul PowerShellu pro správu prostředků Azure Resource Manageru (ARM) pomocí PowerShellu.

Syntaxe

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

Description

Rutina Add-AzureAccount zpřístupňuje váš účet Azure a jeho předplatná ve Windows PowerShellu. Je to jako přihlášení k účtu Azure ve Windows PowerShellu. K odhlášení z účtu použijte rutinu Remove-AzureAccount .

Doplněk AzureAccount stáhne informace o vašem účtu Azure a uloží je do datového souboru předplatného ve vašem cestovním profilu uživatele. Získá také přístupový token, který windows PowerShellu umožňuje přístup k vašemu účtu Azure vaším jménem. Po dokončení příkazu můžete spravovat svůj účet Azure ve Windows PowerShellu.

Pro Windows PowerShell můžete svůj účet Azure zpřístupnit dvěma různými způsoby. Můžete použít rutinu Add-AzureAccount , která používá přístupové tokeny ověřování Microsoft Entra nebo Import-AzurePublishSettingsFile, která používá certifikát pro správu. Pokyny k tomu, kterou metodu použít, najdete v tématu Postupy: Připojení k předplatnému (https://azure.microsoft.com/documentation/articles/install-configure-powershell/#Connect).

Když spustíte Add-AzureAccount, zobrazí se interaktivní okno s výzvou k přihlášení k účtu Azure. Toto přihlášení je platné, dokud nevyprší platnost přístupového tokenu. Po vypršení platnosti se rutiny, které vyžadují přístup k vašemu účtu, zobrazí výzvu ke spuštění příkazu Add-AzureAccount znovu.

Toto téma popisuje rutinu ve verzi 0.8.10 modulu Microsoft Azure PowerShell. Pokud chcete získat verzi modulu, který používáte, zadejte (Get-Module -Name Azure).Versionv konzole Azure PowerShellu .

Příklady

Příklad 1: Přidání účtu

PS C:\> Add-AzureAccount

Tento příkaz přidá účet Azure do Windows PowerShellu. Při spuštění příkazu se zobrazí okno s žádostí o uživatelské jméno a heslo účtu.

Příklad 2: Použití alternativního datového souboru předplatného

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

Tento příkaz používá parametr SubscriptionDataFile k přímému příkazu Add-AzureAccount k uložení dat účtu do souboru C:\Testing\SDF.xml místo výchozího souboru.

Parametry

-Credential

Typ:PSCredential
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Environment

Určuje prostředí Azure.

Prostředí Azure nezávislé nasazení Microsoft Azure, jako je AzureCloud pro globální Azure a AzureChinaCloud pro Azure provozované společností 21Vianet v Číně. Místní prostředí Azure můžete vytvořit také pomocí azure Packu a rutin WAPacku. Další informace najdete v tématu Azure Pack.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Profile

Určuje profil Azure, ze kterého se tato rutina čte. Pokud nezadáte profil, tato rutina načte z místního výchozího profilu.

Typ:AzureSMProfile
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ServicePrincipal

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Tenant

Typ:String
Aliasy:TenantId
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

None

Vstup do této rutiny nelze převést.

Výstupy

None

Tato rutina nevrací žádný výstup.

Poznámky

  • Add-AzureAccount (a metoda ověřování Microsoft Entra) má přednost před Import-AzurePublishSettings (a metodou certifikátu pro správu). Pokud použijete Add-AzureAccount i jednou na svém účtu, použije se metoda ověřování Microsoft Entra a certifikát pro správu se ignoruje. Pokud chcete odebrat token Microsoft Entra a obnovit metodu certifikátu pro správu, použijte rutinu Remove-AzureAccount . Další informace získáte zadáním rutiny Get-Help Remove-AzureAccount.
  • Chyba Vypršela platnost vašich přihlašovacích údajů. Pokud se chcete znovu přihlásit, použijte Add-AzureAccount." znamená, že vypršela platnost přístupového tokenu a Prostředí Windows PowerShell nemá přístup k vašemu účtu Azure. Pokud chcete obnovit přístup ke svému účtu, spusťte příkaz Add-AzureAccount znovu.
  • Rutiny účtu Azure PowerShellu a předplatného získávají data z datového souboru předplatného, ne z živého účtu Azure. Pokud změníte svůj účet nebo předplatná mimo Windows PowerShell, například pomocí portálu pro správu Azure, spusťte příkaz Add-AzureAccount znovu a aktualizujte datový soubor předplatného.