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

Add-AzureAccount

将 Azure 帐户添加到 Windows PowerShell。

注意

本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧 Azure 资源。 创建新的资源时,不建议使用此旧版 PowerShell 模块,因为 ASM 计划停用。 有关详细信息,请参阅 Azure Service Manager 停用

Az PowerShell 模块是推荐的 PowerShell 模块,用于使用 PowerShell 管理 Azure 资源管理器 (ARM) 资源。

语法

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-AzurePublishSettingsFile。 有关使用哪种方法的指导,请参阅 如何:连接到订阅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

类型:PSCredential
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Environment

指定 Azure 环境。

Azure 环境独立于 azure 部署Microsoft,例如 AzureCloud for global Azure,以及由世纪互联在中国运营的 AzureChinaCloud for Azure。 还可以使用 Azure Pack 和 WAPack cmdlet 创建本地 Azure 环境。 有关详细信息,请参阅 Azure Pack

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Profile

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

类型:AzureSMProfile
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ServicePrincipal

类型:SwitchParameter
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Tenant

类型:String
别名:TenantId
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

输入

None

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

输出

None

此 cmdlet 不返回任何输出。

备注

  • Add-AzureAccount (和 Microsoft Entra 身份验证方法)优先于 Import-AzurePublishSettings (和管理证书方法)。 如果在 帐户上使用 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 以刷新订阅数据文件。