你当前正在访问 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 的 Azure 资源管理器 (ARM) 资源的 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-AzurePublishSettingsFile。

运行 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

输出