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 的别名。
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。
相关链接
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈