共用方式為

Get-Alias

  • 參考
模組:
Microsoft.PowerShell.Utility

取得目前會話的別名。

語法

Get-Alias
   [[-Name] <String[]>]
   [-Exclude <String[]>]
   [-Scope <String>]
   [<CommonParameters>]
Get-Alias
   [-Exclude <String[]>]
   [-Scope <String>]
   [-Definition <String[]>]
   [<CommonParameters>]

Description

Get-Alias Cmdlet 會取得目前會話中的別名。 這包括內建別名、您已設定或匯入的別名，以及已新增至 PowerShell 配置檔的別名。

根據預設，Get-Alias 接受別名並傳回命令名稱。 當您使用 Definition 參數時，Get-Alias 會取得命令名稱並傳回其別名。

從 Windows PowerShell 3.0 開始，Get-Alias 以 <alias> -> <definition> 格式顯示非連字元別名名稱，讓您更輕鬆地找到您需要的資訊。

範例

範例 1：取得目前會話中的所有別名

PS C:\> Get-Alias

CommandType     Name
-----------     ----
Alias           % -> ForEach-Object
Alias           ? -> Where-Object
Alias           ac -> Add-Content
Alias           asnp -> Add-PSSnapin
Alias           cat -> Get-Content
Alias           cd -> Set-Location
Alias           chdir -> Set-Location
Alias           clc -> Clear-Content
Alias           clear -> Clear-Host
Alias           clhy -> Clear-History
...

此命令會取得目前會話中的所有別名。

輸出會顯示 Windows PowerShell 3.0 中引進的 <alias> -> <definition> 格式。 此格式僅用於不包含連字元的別名，因為具有連字元的別名通常是 Cmdlet 和函式的慣用名稱，而不是暱稱。

範例 2：依名稱取得別名

Get-Alias -Name gp*, sp* -Exclude *ps

此命令會取得以 gp 或 sp 開頭的所有別名，但結尾為 ps 的別名除外。

範例 3：取得 Cmdlet 的別名

Get-Alias -Definition Get-ChildItem

此命令會取得 Get-ChildItem Cmdlet 的別名。

根據預設，Get-Alias Cmdlet 會在您知道別名時取得項目名稱。 當您知道項目名稱時，Definition 參數會取得別名。

範例 4：依屬性取得別名

Get-Alias | Where-Object {$_.Options -Match "ReadOnly"}

此命令會取得 Options 屬性值為 ReadOnly 的所有別名。 此命令提供快速的方法來尋找PowerShell內建的別名，因為它們具有ReadOnly選項。

Options 只是 Get-Alias 取得之 AliasInfo 物件的一個屬性。 若要尋找 AliasInfo 物件的所有屬性和方法，請輸入 Get-Alias | get-member。

範例 5：依名稱取得別名，並依起始字母篩選

Get-Alias -Definition "*-PSSession" -Exclude e* -Scope Global

此範例會取得名稱為 「-PSSession」 結尾的命令別名，但開頭為 「e」 的命令除外。

此命令會使用 Scope 參數，在全域範圍中套用命令。 當您想要在會話中取得別名時，這在腳本中很有用。

參數

-Definition

取得指定項目的別名。 輸入 Cmdlet、函式、腳本、檔案或可執行文件的名稱。

此參數稱為 Definition，因為它會在 alias 物件的 Definition 屬性中搜尋項目名稱。

類型:String[]
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:True

-Exclude

省略指定的專案。 此參數的值會限定Name和Definition參數。 輸入名稱、定義或模式，例如 「s*」。 允許通配符。

類型:String[]
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:True

-Name

指定這個 Cmdlet 取得的別名。 允許通配符。 根據預設，Get-Alias 擷取目前會話定義的所有別名。 參數名稱 Name 為選擇性。 您也可以使用管線將別名名稱傳送至 Get-Alias。

類型:String[]
Position:0
預設值:All aliases
必要:False
接受管線輸入:True
接受萬用字元:True

-Scope

指定這個 Cmdlet 取得別名的範圍。 此參數可接受的值為：

  • 全球
  • 當地
  • 腳本
  • 相對於目前範圍的數位（0 到範圍的數目，其中0是目前的範圍，1是其父系）

本機是預設值。 如需詳細資訊，請參閱 about_Scopes。

類型:String
Position:Named
預設值:Local
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

String

您可以使用管線 將別名名稱傳送至 get-Alias。

輸出

AliasInfo

Get-Alias 會傳回代表每個別名的物件。 Get-Alias 會針對每個別名傳回相同的物件，但 PowerShell 會使用箭號格式來顯示非連字元別名的名稱。

備註

  • 若要建立新的別名，請使用 Set-Alias 或 New-Alias。 若要刪除別名，請使用 Remove-Item。
  • 箭頭型別名名稱格式不適用於包含連字元的別名。 這些可能是 Cmdlet 和函式的慣用替代名稱，而不是一般縮寫或暱稱。