你当前正在访问 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-AzureAccount 或 Import-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 返回布尔值。 否则,将不返回任何输出。