Share via

Remove-Alias

  • 参考
模块:
Microsoft.PowerShell.Utility

从当前会话中删除别名。

语法

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

说明

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

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

示例

示例 1 - 删除别名

此示例删除一个名为 del 的别名，该别名表示 cmdlet Remove-Item 。

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 (不等于) ，选择未将 Options 值设置为 常量的对象。 Remove-Alias 使用 Force 参数从 PowerShell 会话中删除别名，包括只读别名。

参数

-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

仅影响指定范围内的别名。 默认作用域为 “本地”。 有关详细信息，请参阅 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[]

可以通过管道将别名对象传递给 Remove-Alias。

输出

None

此 cmdlet 不返回任何输出。

备注

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

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