Get-Alias

模組:
Microsoft.PowerShell.Utility Module

拿到本場次的別名。

語法

Default (預設值) 

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

Definition 

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

Description

Get-Alias指令小程式在當前工作階段取得別名。 這包括內建別名、你設定或匯入的別名，以及你在 PowerShell 設定檔中新增的別名。

預設情況下，會 Get-Alias 使用別名並回傳指令名稱。 當你使用 Definition 參數時，會 Get-Alias 取一個指令名稱並回傳它的別名。

從 PowerShell 3.0 Windows 開始，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
...

此指令會取得當前會話中的所有別名。

輸出顯示的是 PowerShell 3.0 引入Windows <alias> -> <definition>格式。 此格式僅用於不含連字號的別名，因為帶有連字號的別名通常是 cmdlet 和函式的首選名稱，而非暱稱。

範例二：以姓名取得別名

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

此指令接收所有以 gp 或 sp 開頭的別名，唯獨以 ps 結尾的別名除外。

範例 3：取得指令檔的別名

Get-Alias -Definition Get-ChildItem

此指令取得指令的別名 Get-ChildItem 。

預設情況下，當你知道別名時，指令 Get-Alias 長會取得項目名稱。 當你知道項目名稱時， Definition 參數會取得別名。

範例 4：依屬性取得別名

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

此指令取得所有 選項屬性值 為 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 屬性中搜尋項目名稱。

參數屬性

類型:

String[]

預設值:None
支援萬用字元:True
不要顯示:False

參數集

Definition
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Exclude

省略了指定的項目。 此參數的值用以限定 名稱 與 定義 參數。 輸入一個名稱、定義或模式，例如「s*」。 允許使用通配符。

參數屬性

類型:

String[]

預設值:None
支援萬用字元:True
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Name

指定此指令小程式所獲得的別名。 允許使用通配符。 預設情況下，會 Get-Alias 取得目前會話中定義的所有別名。 參數名稱 Name 是可選的。 你也可以把別名管道接到 Get-Alias。

參數屬性

類型:

String[]

預設值:All aliases
支援萬用字元:True
不要顯示:False

參數集

Default
Position:0
必要:False
來自管線的值:True
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Scope

指定此指令匣獲得別名的範圍。 此參數可接受的值為：

  • Global
  • Local
  • Script
  • 相對於目前範圍的數字（0 到範圍的總數，其中0是目前的範圍，1是其父系）

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

參數屬性

類型:String
預設值:Local
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。

輸入

String

你可以將包含別名名稱的字串輸入這個 cmdlet。

輸出

AliasInfo

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

備註

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

  • 所有平臺：

    • gal

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

  • 箭頭型別名名稱格式不適用於包含連字元的別名。 這些通常是指令小子和函式的首選替代名稱，而非典型的縮寫或暱稱。