Udostępnij za pośrednictwem

Add-AzureAccount

  • Odwołanie
Moduł:
Azure

Dodaje konto platformy Azure do programu Windows PowerShell.

Uwaga

Polecenia cmdlet, do których odwołuje się ta dokumentacja, służą do zarządzania starszymi zasobami platformy Azure korzystającymi z interfejsów API programu Azure Service Manager (ASM). Ten starszy moduł programu PowerShell nie jest zalecany podczas tworzenia nowych zasobów, ponieważ usługa ASM ma zostać wycofana. Aby uzyskać więcej informacji, zobacz Wycofywanie programu Azure Service Manager.

Moduł Az programu PowerShell jest zalecanym modułem programu PowerShell do zarządzania zasobami usługi Azure Resource Manager (ARM) przy użyciu programu PowerShell.

Składnia

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

Opis

Polecenie cmdlet Add-AzureAccount udostępnia konto platformy Azure i jego subskrypcje w programie Windows PowerShell. To jak logowanie się do konta platformy Azure w programie Windows PowerShell. Aby wylogować się z konta, użyj polecenia cmdlet Remove-AzureAccount .

Dodatek AzureAccount pobiera informacje o koncie platformy Azure i zapisuje je w pliku danych subskrypcji w profilu użytkownika mobilnego. Uzyskuje również token dostępu, który umożliwia programowi Windows PowerShell dostęp do konta platformy Azure w Twoim imieniu. Po zakończeniu wykonywania polecenia możesz zarządzać kontem platformy Azure w programie Windows PowerShell.

Istnieją dwa różne sposoby udostępniania konta platformy Azure programowi Windows PowerShell. Możesz użyć polecenia cmdlet Add-AzureAccount , które używa tokenów dostępu uwierzytelniania entra firmy Microsoft lub Import-AzurePublishSettingsFile, które używa certyfikatu zarządzania. Aby uzyskać wskazówki dotyczące używanej metody, zobacz Instrukcje: nawiązywanie połączenia z subskrypcją (https://azure.microsoft.com/documentation/articles/install-configure-powershell/#Connect).

Po uruchomieniu polecenia Add-AzureAccount zostanie wyświetlone interaktywne okno z monitem o zalogowanie się do konta platformy Azure. To logowanie jest prawidłowe do momentu wygaśnięcia tokenu dostępu. Po wygaśnięciu polecenia cmdlet, które wymagają dostępu do konta, monituje o ponowne uruchomienie polecenia Add-AzureAccount .

W tym temacie opisano polecenie cmdlet w wersji 0.8.10 modułu Microsoft Azure PowerShell. Aby uzyskać wersję używanego modułu, w konsoli programu Azure PowerShell wpisz (Get-Module -Name Azure).Version.

Przykłady

Przykład 1. Dodawanie konta

PS C:\> Add-AzureAccount

To polecenie dodaje konto platformy Azure do programu Windows PowerShell. Po uruchomieniu polecenia zostanie wyświetlone okno, aby zażądać nazwy użytkownika i hasła konta.

Przykład 2. Używanie alternatywnego pliku danych subskrypcji

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

To polecenie używa parametru SubscriptionDataFile , aby skierować polecenie Add-AzureAccount do przechowywania danych konta w pliku C:\Testing\SDF.xml zamiast pliku domyślnego.

Parametry

-Credential

Typ:PSCredential
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Environment

Określa środowisko platformy Azure.

Środowisko platformy Azure niezależne wdrożenie platformy Microsoft Azure, takie jak AzureCloud for global Azure i AzureChinaCloud for Azure obsługiwane przez firmę 21Vianet w Chinach. Możesz również tworzyć lokalne środowiska platformy Azure przy użyciu pakietu Azure Pack i poleceń cmdlet WAPack. Aby uzyskać więcej informacji, zobacz Azure Pack.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Profile

Określa profil platformy Azure, z którego to polecenie cmdlet odczytuje. Jeśli nie określisz profilu, to polecenie cmdlet odczytuje z lokalnego profilu domyślnego.

Typ:AzureSMProfile
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ServicePrincipal

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Tenant

Typ:String
Aliasy:TenantId
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

None

Nie można przekazać danych wejściowych potoku do tego polecenia cmdlet

Dane wyjściowe

None

To polecenie cmdlet nie zwraca żadnych danych wyjściowych.

Uwagi

  • Opcja Add-AzureAccount (i metoda uwierzytelniania Entra firmy Microsoft) ma pierwszeństwo przed wartością Import-AzurePublishSettings (i metodą certyfikatu zarządzania). Jeśli używasz polecenia Add-AzureAccount nawet raz na twoim koncie, zostanie użyta metoda uwierzytelniania Microsoft Entra i certyfikat zarządzania zostanie zignorowany. Aby usunąć token Microsoft Entra i przywrócić metodę certyfikatu zarządzania, użyj polecenia cmdlet Remove-AzureAccount . Aby uzyskać więcej informacji, wpisz: Get-Help Remove-AzureAccount.
  • Błąd "Twoje poświadczenia wygasły. Użyj polecenia Add-AzureAccount, aby zalogować się ponownie." wskazuje, że token dostępu wygasł, a program Windows PowerShell nie może uzyskać dostępu do konta platformy Azure. Aby przywrócić dostęp do konta, uruchom ponownie polecenie Add-AzureAccount .
  • Polecenia cmdlet konta i subskrypcji programu Azure PowerShell pobierają dane z pliku danych subskrypcji, a nie z konta platformy Azure na żywo. Jeśli zmienisz konto lub subskrypcje poza programem Windows PowerShell, na przykład przy użyciu portalu zarządzania Platformy Azure, uruchom ponownie polecenie Add-AzureAccount , aby odświeżyć plik danych subskrypcji.