次の方法で共有


Get-Alias

現在のセッションのエイリアスを取得します。

構文

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

説明

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
...

このコマンドは、現在のセッションのすべてのエイリアスを取得します。

出力には、Windows PowerShell 3.0 で導入された <alias> -> <definition> 形式が表示されます。 通常、ハイフン付きのエイリアスは、ニックネームの代わりに、コマンドレットと関数の推奨される名前になるため、この形式はハイフンを含まないエイリアスのみに使用されます。

例 2: 名前でエイリアスを取得する

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

このコマンドは、ps で終わるエイリアスを除き、gp または sp で始まるすべてのエイリアスを取得します。

例 3: コマンドレットのエイリアスを取得する

Get-Alias -Definition Get-ChildItem

このコマンドは、 Get-ChildItem コマンドレットのエイリアスを取得します。

既定では、エイリアスがわかっている場合、 Get-Alias コマンドレットは項目名を取得します。 Definition パラメーターは、項目名がわかっている場合にエイリアスを取得します。

例 4: プロパティでエイリアスを取得する

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

このコマンドは、Options プロパティの値がReadOnlyするすべてのエイリアスを取得します。 このコマンドを使用すると、 ReadOnly オプションがあるため、PowerShell に組み込まれているエイリアスをすばやく見つけることができます。

Options は、Get-Aliasが取得する AliasInfo オブジェクトの 1 つのプロパティにすぎません。 AliasInfo オブジェクトのすべてのプロパティとメソッドを検索するには、「Get-Alias | get-member」と入力します。

例 5: 名前でエイリアスを取得し、先頭文字でフィルター処理する

Get-Alias -Definition "*-PSSession" -Exclude e* -Scope Global

この例では、"e" で始まるエイリアスを除き、"-PSSession" で終わる名前を持つコマンドのエイリアスを取得します。

このコマンドでは、 Scope パラメーターを使用して、グローバル スコープにコマンドを適用します。 これは、セッション内のエイリアスを取得するときに、スクリプトで役立ちます。

パラメーター

-Definition

指定した項目のエイリアスを取得します。 コマンドレット、関数、スクリプト、ファイル、または実行可能ファイルの名前を入力します。

このパラメーターは、エイリアス オブジェクトの Definition プロパティで項目名を検索するため、 Definition と呼ばれます。

型:String[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:True

-Exclude

指定した項目を除外します。 このパラメーターの値は、 Name および Definition パラメーターを修飾します。 名前、要素、または「s*」のようなパターンを入力します。 ワイルドカードを使用できます。

型:String[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:True

-Name

このコマンドレットが取得するエイリアスを指定します。 ワイルドカードを使用できます。 既定では、 Get-Alias は現在のセッションに対して定義されているすべてのエイリアスを取得します。 パラメーター名 Name は省略可能です。 エイリアス名をパイプして Get-Aliasすることもできます。

型:String[]
配置:0
規定値:All aliases
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:True

-Scope

このコマンドレットがエイリアスを取得するスコープを指定します。 このパラメーターの有効値は、次のとおりです。

  • Global
  • Local
  • Script
  • 現在のスコープに対する相対的な数値 (0 からスコープの数、0 が現在のスコープ、1 がその親)

Local は既定値です。 詳細については、「 about_Scopes」を参照してください。

型:String
配置:Named
規定値:Local
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

String

エイリアス名を含む文字列をこのコマンドレットにパイプできます。

出力

AliasInfo

このコマンドレットは、各エイリアスを表すオブジェクトを返します。 すべてのエイリアスに対して同じ種類のオブジェクトが返されますが、PowerShell では矢印ベースの形式を使用して、ハイフネーションされていないエイリアスの名前が表示されます。

メモ

Windows PowerShell には、 Get-Aliasの次のエイリアスが含まれています。

  • gal

  • 新しいエイリアスを作成するには、 Set-Alias または New-Aliasを使用します。 エイリアスを削除するには、 Remove-Itemを使用します。

  • 矢印に基づくエイリアス名の形式は、ハイフンを含むエイリアスには使用されません。 これらは、一般的な省略形またはニックネームの代わりに、コマンドレットと関数の推奨される代替名となる可能性が高くなります。