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

Remove-AzureAccount

从 Windows PowerShell 中删除 Azure 帐户。

注意

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

Az PowerShell 模块是建议用于管理 PowerShell 的 Azure 资源管理器 (ARM) 资源的 PowerShell 模块。

语法

Remove-AzureAccount
      -Name <String>
      [-Force]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

说明

Remove-AzureAccount cmdlet 从漫游用户配置文件中的订阅数据文件中删除 Azure 帐户及其订阅。 它不会从 Azure Microsoft中删除帐户,也不会以任何方式更改实际帐户。

使用此 cmdlet 非常类似于注销 Azure 帐户。 如果想要再次登录帐户,请使用 Add-AzureAccountImport-AzurePublishSettingsFile 再次将帐户添加到 Windows PowerShell。

还可以使用 Remove-AzureAccount cmdlet 更改 Azure PowerShell cmdlet 登录到 Azure 帐户的方式。 如果帐户具有 Import-AzurePublishSettingsFile 中的管理证书和 Add-AzureAccount 中的访问令牌,则 Azure PowerShell cmdlet 仅使用访问令牌;它们忽略管理证书。 若要使用管理证书,请运行 Remove-AzureAccount。 当 Remove-AzureAccount 同时找到管理证书和访问令牌时,它只删除访问令牌,而不是删除帐户。 管理证书仍然存在,因此帐户仍可用于 Windows PowerShell。

本主题介绍 Microsoft Azure PowerShell 模块的 0.8.10 版本中的 cmdlet。 若要获取正在使用的模块版本,请在 Azure PowerShell 控制台中键入 (Get-Module -Name Azure).Version

示例

示例 1:删除帐户

PS C:\> Remove-AzureAccount -Name admin@contoso.com

此命令从 admin@contoso.com 订阅数据文件中删除该命令。 命令完成后,该帐户不再可用于 Windows PowerShell。

参数

-Confirm

提示你在运行 cmdlet 之前进行确认。

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

-Force

取消确认提示。 默认情况下, Remove-AzureAccount 在从 Windows PowerShell 中删除帐户之前会提示你。

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

-Name

指定要删除的帐户的名称。 参数值区分大小写。 不支持通配符。

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

-PassThru

如果命令成功,$False失败,则返回$True。 默认情况下,此 cmdlet 不返回任何输出。

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

-Profile

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

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

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

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

输入

None

可以通过属性名称(而不是值)通过管道将输入传递给此 cmdlet。

输出

None or System.Boolean

如果使用 PassThru 参数,则此 cmdlet 返回布尔值。 否则,将不返回任何输出。