Поделиться через

Add-AzureAccount

  • Ссылка
Модуль:
Azure

Добавляет учетную запись Azure в Windows PowerShell.

Примечание.

Командлеты, на которые ссылается эта документация, предназначены для управления устаревшими ресурсами Azure, используюющими API Azure Service Manager (ASM). Этот устаревший модуль PowerShell не рекомендуется при создании новых ресурсов, так как ASM планируется выйти на пенсию. Дополнительные сведения см. в статье о выходе на пенсию в Azure Service Manager.

Модуль Az PowerShell — это рекомендуемый модуль PowerShell для управления ресурсами Azure Resource Manager (ARM) с помощью PowerShell.

Синтаксис

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

Описание

Командлет Add-AzureAccount делает свою учетную запись Azure и ее подписки доступными в Windows PowerShell. Это похоже на вход в учетную запись Azure в Windows PowerShell. Чтобы выйти из учетной записи, используйте командлет Remove-AzureAccount .

Надстройка AzureAccount скачивает сведения о вашей учетной записи Azure и сохраняет его в файле данных подписки в перемещаемом профиле пользователя. Он также получает маркер доступа, позволяющий Windows PowerShell получать доступ к вашей учетной записи Azure от вашего имени. По завершении команды вы можете управлять учетной записью Azure в Windows PowerShell.

Существует два разных способа сделать учетную запись Azure доступной в Windows PowerShell. Вы можете использовать командлет Add-AzureAccount , который использует маркеры доступа к проверке подлинности Microsoft Entra или Import-AzurePublishSettingsFile, который использует сертификат управления. Инструкции по использованию метода см. в статье "Практическое руководство. Подключение к подписке (https://azure.microsoft.com/documentation/articles/install-configure-powershell/#Connect).

При запуске Надстройки AzureAccount отображается интерактивное окно, которое предложит войти в учетную запись Azure. Этот вход действителен до истечения срока действия маркера доступа. По истечении срока действия командлеты, требующие доступа к учетной записи, снова запускают надстройку AzureAccount .

В этом разделе описывается командлет в версии 0.8.10 модуля Microsoft Azure PowerShell. Чтобы получить версию используемого модуля, в консоли Azure PowerShell введите (Get-Module -Name Azure).Version.

Примеры

Пример 1. Добавление учетной записи

PS C:\> Add-AzureAccount

Эта команда добавляет учетную запись Azure в Windows PowerShell. При выполнении команды появится окно, чтобы запросить имя пользователя и пароль учетной записи.

Пример 2. Использование альтернативного файла данных подписки

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

Эта команда использует параметр SubscriptionDataFile для прямого хранения данных учетной записи в файле C:\Testing\SDF.xml вместо файла по умолчанию.

Параметры

-Credential

Тип:PSCredential
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Environment

Указывает среду Azure.

Среда Azure независимое развертывание Microsoft Azure, например AzureCloud для глобальной среды Azure и AzureChinaCloud для Azure под управлением 21Vianet в Китае. Вы также можете создавать локальные среды Azure с помощью Azure Pack и командлетов WAPack. Дополнительные сведения см. в пакете Azure.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Profile

Указывает профиль Azure, из которого считывается этот командлет. Если профиль не указан, этот командлет считывается из локального профиля по умолчанию.

Тип:AzureSMProfile
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ServicePrincipal

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Tenant

Тип:String
Aliases:TenantId
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

None

Не удается передать входные данные в этот командлет

Выходные данные

None

Этот командлет не возвращает никакие выходные данные.

Примечания

  • Add-AzureAccount (и метод проверки подлинности Microsoft Entra) имеет приоритет над import-AzurePublishSettings (и методом сертификата управления). Если вы используете Add-AzureAccount даже один раз в учетной записи, используется метод проверки подлинности Microsoft Entra, а сертификат управления игнорируется. Чтобы удалить маркер Microsoft Entra и восстановить метод сертификата управления, используйте командлет Remove-AzureAccount . Дополнительные сведения введите: Get-Help Remove-AzureAccount.
  • Ошибка "Срок действия учетных данных истек. Используйте Add-AzureAccount для повторного входа в систему". Указывает, что срок действия маркера доступа истек, и Windows PowerShell не может получить доступ к учетной записи Azure. Чтобы восстановить доступ к учетной записи, снова запустите Add-AzureAccount .
  • Командлеты учетной записи Azure PowerShell и подписки получают данные из файла данных подписки, а не из динамической учетной записи Azure. Если вы изменяете учетную запись или подписки за пределами Windows PowerShell, например с помощью портала управления Azure, запустите надстройку AzureAccount еще раз, чтобы обновить файл данных подписки.