你当前正在访问 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 以刷新订阅数据文件。