Remove-Alias

从当前会话中移除别名。

语法

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

说明

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

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

示例

示例 1 - 移除别名

此示例移除名为 del 的别名,该别名表示 Remove-Item cmdlet。

Remove-Alias -Name del

示例 2 - 移除所有非 Constant 别名

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

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

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

参数

-Force

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

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

-Name

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

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

-Scope

仅影响指定作用域中的别名。 默认作用域为 Local。 有关详细信息,请参阅 about_Scopes

此参数的可接受值为:

  • Global
  • Local
  • Script
  • 一个相对于当前作用域的数字(0 到作用域数,其中 0 是指当前作用域,1 是指其父作用域)
类型:String
Position:Named
默认值:Local
必需:False
接受管道输入:False
接受通配符:False

输入

String[]

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

输出

None

此 cmdlet 不返回任何输出。

备注

更改仅影响当前作用域。 若要从所有会话中移除别名,请将 Remove-Alias 命令添加到 PowerShell 配置文件。

有关详细信息,请参阅 about_Aliases