Remove-Alias
從目前的會話中移除別名。
Syntax
Remove-Alias
[-Name] <String[]>
[-Scope <String>]
[-Force]
[<CommonParameters>]
Description
Cmdlet Remove-Alias
會從目前的PowerShell工作階段中移除別名。 若要移除 Option 屬性設定為 ReadOnly 的別名,請使用 Force 參數。
Cmdlet Remove-Alias
是在 PowerShell 6.0 中引進。
範例
範例 1 - 移除別名
此範例會移除名為 del
的別名,此 Remove-Item
別名代表 Cmdlet。
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值設定為 Constant 的物件。 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
只會影響指定範圍中的別名。 默認範圍為 Local。 如需詳細資訊,請參閱 about_Scopes。
此參數可接受的值為:
- 全球
- 本機
- 指令碼
- 相對於目前範圍的數字 (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。