你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Add-AzureAccount

将 Azure 帐户添加到 Windows PowerShell。

注意

本文档中引用的 cmdlet 用于管理使用服务管理 API 的旧式 Azure 资源。 若要了解用于管理 Azure 资源管理器资源的 cmdlet,请参阅 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 cmdlet 使 Azure 帐户及其订阅在 Windows PowerShell 中可用。 就像在 Windows PowerShell 中登录到 Azure 帐户一样。 若要注销帐户,请使用 Remove-AzureAccount cmdlet。

Add-AzureAccount 下载有关 Azure 帐户的信息,并将其保存在漫游用户配置文件的订阅数据文件中。 它还获取一个访问令牌,该令牌允许 Windows PowerShell 代表你访问 Azure 帐户。 命令完成后,可以在 Windows PowerShell 中管理 Azure 帐户。

有两种不同的方法可用于 Windows PowerShell 的 Azure 帐户。 可以使用 Add-AzureAccount cmdlet,该 cmdlet 使用 Microsoft Entra 身份验证访问令牌,也可以使用使用管理证书的 Import-AzurePublish设置File。 有关如何使用的方法的指导,请参阅如何:连接订阅https://azure.microsoft.com/documentation/articles/install-configure-powershell/#Connect)。

运行 Add-AzureAccount 时,它会显示一个交互式窗口,提示你登录到 Azure 帐户。 此登录在访问令牌过期之前有效。 过期后,需要访问帐户的 cmdlet 会提示你再次运行 Add-AzureAccount

本主题介绍 Microsoft Azure PowerShell 模块 0.8.10 版本中的 cmdlet。 若要获取正在使用的模块版本,请在 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 参数指示 Add-AzureAccount 将帐户数据存储在 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 for global Azure,以及由世纪互联在中国运营的 AzureChinaCloud for Azure。 还可以使用 Azure Pack 和 WAPack cmdlet 创建本地 Azure 环境。 有关详细信息,请参阅 Azure Pack

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

-Profile

指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件,此 cmdlet 将从本地默认配置文件中读取。

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

无法通过管道将输入传递给此 cmdlet

输出

None

此 cmdlet 不返回任何输出。

备注

  • Add-AzureAccount(和 Microsoft Entra 身份验证方法)优先于 Import-AzurePublish设置(和管理证书方法)。 如果在帐户上使用 Add-AzureAccount ,则使用 Microsoft Entra 身份验证方法并忽略管理证书。 若要删除 Microsoft Entra 令牌并还原管理证书方法,请使用 Remove-AzureAccount cmdlet。 有关详细信息,请键入: Get-Help Remove-AzureAccount
  • 错误“凭据已过期。 请使用 Add-AzureAccount 再次登录。“表示访问令牌已过期,Windows PowerShell 无法访问 Azure 帐户。 若要还原对帐户的访问权限,请再次运行 Add-AzureAccount
  • Azure PowerShell 帐户和订阅 cmdlet 从订阅数据文件(而不是实时 Azure 帐户)获取其数据。 如果在 Windows PowerShell 之外更改帐户或订阅,例如使用 Azure 管理门户,请再次运行 Add-AzureAccount 以刷新订阅数据文件。