你当前正在访问 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 模块,用于使用 PowerShell 管理 Azure 资源管理器 (ARM) 资源。

语法

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
Aliases:cf
Position:Named
默认值:False
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

类型:SwitchParameter
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

类型:String
Position:Named
默认值:None
必需:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

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

类型:SwitchParameter
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-Profile

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

类型:AzureSMProfile
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

类型:SwitchParameter
Aliases:wi
Position:Named
默认值:False
必需:False
Accept pipeline input:False
Accept wildcard characters:False

输入

None

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

输出

None or System.Boolean

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