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

Add-AzureAccount

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

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

Примечание.

Командлеты, приведенные в этой документации, предназначены для управления устаревшими ресурсами Azure, которые используют API-интерфейсами управления службами. Командлеты для управления ресурсами Azure Resource Manager см. в статье Модуль Az 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-AzurePublish Параметры File, который использует сертификат управления. Инструкции по использованию метода см. в статье "Практическое руководство. Подключение в подписку (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

Type:PSCredential
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Environment

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

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Profile

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

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServicePrincipal

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Tenant

Type:String
Aliases:TenantId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

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

None

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

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

None

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

Примечания

  • Add-AzureAccount (и метод проверки подлинности Microsoft Entra) имеет приоритет над Import-AzurePublish Параметры (и методом сертификата управления). Если вы используете 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 еще раз, чтобы обновить файл данных подписки.