Get-Alias
取得目前工作階段的別名。
Syntax
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
...
此命令取得目前工作階段中的所有別名。
輸出會顯示<alias> -> <definition>
在 Windows PowerShell 3.0 中引進的格式。
此格式只用於不含連字號的別名,因為含連字號的別名通常是 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,因為它會在別名物件的 Definition 屬性中搜尋項目名稱。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Exclude
省略指定的項目。 此參數的值會限定 Name 和 Definition 參數。 輸入名稱、定義或模式,例如 "s*"。 允許使用萬用字元。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Name
指定這個 Cmdlet 取得的別名。
允許使用萬用字元。
根據預設, Get-Alias
擷取為目前會話定義的所有別名。
參數名稱 Name 是選擇性的。
您也可以使用管線將別名名稱傳送至 Get-Alias
。
Type: | String[] |
Position: | 0 |
Default value: | All aliases |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Scope
指定這個 Cmdlet 取得別名的範圍。 此參數可接受的值為:
- 全球
- 本機
- 指令碼
- 相對於目前範圍的數字 (0 至範圍數目,0 為目前範圍,1 為其父系)。
Local 為預設值。 如需詳細資訊,請參閱 about_Scopes。
Type: | String |
Position: | Named |
Default value: | Local |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
輸入
您可以使用管線將別名名稱傳送至 Get-Alias。
輸出
Get-Alias 會傳回代表每個別名的物件。 Get-Alias 會針對每個別名傳回相同的物件,但 PowerShell 會使用箭號格式來顯示非連字元別名的名稱。
備註
- 若要建立新的別名,請使用 Set-Alias 或 New-Alias。 若要刪除別名,請使用 Remove-Item。
- 箭號型別名名稱格式不會用於含連字號的別名。 這些可能是 Cmdlet 和函式的慣用替代名稱,而不是典型的縮寫或暱稱。