Remove-Alias

  • 參考
模組:
Microsoft.PowerShell.Utility

從目前的會話移除別名。

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 參數無法移除常數別名。

參數

-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。