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 - 移除别名

此示例移除名为 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 的别名。

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Scope

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

此参数的可接受值为：

  • Global
  • Local
  • Script
  • 一个相对于当前作用域的数字（0 到作用域数，其中 0 是指当前作用域，1 是指其父作用域）
Type:String
Position:Named
Default value:Local
Required:False
Accept pipeline input:False
Accept wildcard characters:False

输入

String[]

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

输出

None

此 cmdlet 不返回任何输出。

备注

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

有关详细信息，请参阅 about_Aliases。