共用方式為

Get-Alias

  • 參考
模組:
Microsoft.PowerShell.Utility

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

Syntax

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

Description

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

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

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

範例

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

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

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

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

範例 4：依屬性取得別名

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

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

Options 只是 取得之 AliasInfo 物件的 Get-Alias 其中一個屬性。 若要尋找 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 取得別名的範圍。 此參數可接受的值為：

  • Global
  • Local
  • Script
  • 相對於目前範圍的數字 (0 至範圍數目，0 為目前範圍，1 為其父系)。

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

Type:String
Position:Named
Default value:Local
Required:False
Accept pipeline input:False
Accept wildcard characters:False

輸入

String

您可以使用管線將包含別名名稱的字串傳送至此 Cmdlet。

輸出

AliasInfo

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

備註

PowerShell 包含下列的 Get-Alias別名：

  • 所有平台：

    • gal

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

  • 箭號型別名名稱格式不會用於含連字號的別名。 這些可能是 Cmdlet 和函式的慣用替代名稱，而不是典型的縮寫或暱稱。