网站搜索

Remove-Alias (Microsoft.PowerShell.Utility)


Remove-Alias

模块 :
Microsoft.PowerShell.Utility

从当前会话中删除别名。

句法

Remove-Alias
      [-Name] <String[]>
      [-Scope <String>]
      [-Force]
      [<CommonParameters>]

描述

Remove-Alias cmdlet 可从当前 PowerShell 会话中删除别名。要删除 Option 属性设置为 ReadOnly 的别名,请使用 Force 参数。

Remove-Alias cmdlet 是在 PowerShell 6.0 中引入的。

示例

示例 1 - 删除别名

此示例删除代表 Remove-Item cmdlet 的名为 del 的别名。

Remove-Alias -Name del

示例 2 - 删除所有非常量别名

此示例从当前 PowerShell 会话中删除所有别名,Options 属性设置为 Constant 的别名除外。运行命令后,别名可在其他 PowerShell 会话或新 PowerShell 会话中使用。

Get-Alias | Where-Object { $_.Options -NE "Constant" } | Remove-Alias -Force

Get-Alias 获取 PowerShell 会话中的所有别名并将对象发送到管道中。 Where-Object 使用脚本块,自动变量 ($_) 和 Options 属性表示当前管道对象。参数NE(不等于)选择选项值未设置为常量的对象。 Remove-Alias 使用 Force 参数从 PowerShell 会话中删除别名,包括只读别名。 Force 参数无法删除Constant 别名。

参数

-Force

指示 cmdlet 删除别名,包括 Option 属性设置为 ReadOnly 的别名。 Force 参数无法删除 Option 属性设置为 Constant 的别名。

类型 :

SwitchParameter

位置:

命名

默认值:

False

必需的:

False

接受管道输入:

False

接受通配符:

False

-Name

指定要删除的别名的名称。

类型 :

String[]

位置:

0

默认值:

None

必需的:

True

接受管道输入:

True

接受通配符:

False

-Scope

仅影响指定范围内的别名。默认范围是本地。有关详细信息,请参阅 about_Scopes。

该参数可接受的值为:

    Global
    Local
    Script
  • 相对于当前作用域的数字(0 到作用域数量,其中 0 是当前作用域,1 是其父作用域)
类型 :

String

位置:

命名

默认值:

当地的

必需的:

False

接受管道输入:

False

接受通配符:

False

输入

字符串[]

您可以通过管道将别名对象传递给此 cmdlet。

输出

无

此 cmdlet 不返回任何输出。

笔记

更改仅影响当前范围。要从所有会话中删除别名,请将 Remove-Alias 命令添加到您的 PowerShell 配置文件中。

有关更多信息,请参阅 about_Aliases。

相关文章