取得目前工作階段的別名。

語法

Get-Alias [[-Name] <string[]>] [-Exclude <string[]>] [-Scope <string>] [<CommonParameters>]

Get-Alias [-Definition <string[]>] [-Exclude <string[]>] [-Scope <string>] [<CommonParameters>]

描述

Get-Alias Cmdlet 會取得目前工作階段中的別名 (命令及可執行檔的交替名稱),包括內建的別名、已經設定或匯入的別名,以及已經新增到 Windows PowerShell 設定檔的別名。

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

參數

-Definition <string[]>

取得指定之項目的別名。請輸入 Cmdlet、函數、指令碼、檔案或可執行檔的名稱。

此參數稱為 Definition,因在別名物件的 Definition 屬性中搜尋項目名稱而得名。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

true

-Exclude <string[]>

忽略指定的項目。此參數的值會限定 Name 和 Definition 參數。請輸入名稱、定義或模式,例如 "s*"。允許使用萬用字元。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-Name <string[]>

指定要擷取的別名。允許使用萬用字元。根據預設,Get-Alias 會擷取所有為目前工作階段定義的別名。參數名稱 ("Name") 為選擇項。您也可經由管道將別名輸出至 Get-Alias。

必要?

false

位置?

1

預設值

接受管線輸入?

true (ByValue, ByPropertyName)

接受萬用字元?

false

-Scope <string>

只取得指定之範圍中的別名。有效的值包括 "Global"、"Local"、"Script" 或相對於目前範圍的數字 (從 0 到範圍總數,其中 0 代表目前範圍,1 代表其上層)。預設值為 "Local"。如需詳細資訊,請參閱 about_Scopes。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

<CommonParameters>

這個 Cmdlet 支援一般參數:-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊,請參閱 about_Commonparameters.

輸入和輸出

輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。

輸入

System.String

您可經由管道將別名輸出至 Get-Alias。

輸出

System.Management.Automation.AliasInfo

Get-Alias 會傳回代表每個別名的物件。

附註

別名是 cmdlet、函數或執行檔的交替名稱或暱稱。若要執行 cmdlet、函數或執行檔,您可以使用其全名或任何別名。如需詳細資訊,請參閱 about_Aliases。

若要建立新的別名,請使用 Set-Alias 或 New-Alias。若要刪除別名,請使用 Remove-Item。

範例 1

C:\PS>get-alias

描述
-----------
這個命令會取得目前工作階段中的所有別名。






範例 2

C:\PS>get-alias -name g*, s* -exclude get-*

描述
-----------
這個命令會取得所有以 "g" 或 "s" 開頭的別名,但以 "get-" 開頭的別名則除外。






範例 3

C:\PS>get-alias -definition Get-ChildItem

描述
-----------
這個命令會取得 Get-ChildItem Cmdlet 的別名。

根據預設,Get-Alias Cmdlet 會在指定別名的情況下取得項目名稱。Definition 參數會在指定項目名稱的情況下取得別名。






範例 4

C:\PS>get-alias | where-object {$_.Options -match "ReadOnly"}

描述
-----------
這個命令擷取其 Options 屬性值為 ReadOnly 的所有別名。這個命令提供了快速的方式來尋找 Windows PowerShell 內建的別名,因為這些別名具有 ReadOnly 選項。

Options 只是 Get-Alias 所取得的 AliasInfo 物件的其中一個屬性。若要找出 AliasInfo 物件的所有屬性和方法,請輸入 "get-alias | get-member"。






範例 5

C:\PS>get-alias -definition "*-pssession" -exclude e* -scope global

描述
-----------
這個範例會取得以 "-pssession" 結尾之命令名稱的別名,但以 "e" 開頭的別名則除外。

這個範例會使用 Scope 參數將命令套用於全域範圍。當您要取得工作階段中的別名時,此參數對指令碼很有幫助。






請參閱




目錄