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 開始，以格式顯示非連字元別名名稱<alias> -> <definition>，Get-Alias讓您更輕鬆地尋找您需要的資訊。

範例

範例 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，因為它會在 alias 物件的 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 和函式的慣用替代名稱，而不是一般縮寫或暱稱。