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

Add-AzureAccount

参考

模块:: Azure

将 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

输出