Get-Variable

リファレンス

モジュール:: Microsoft.PowerShell.Utility

現在のコンソール内の変数を取得します。

構文

Get-Variable
   [[-Name] <String[]>]
   [-ValueOnly]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Scope <String>]
   [<CommonParameters>]

説明

コマンドレットは Get-Variable 、現在のコンソールで PowerShell 変数を取得します。 ValueOnly パラメーターを指定することで変数の値だけを取得できます。また、返される変数を名前でフィルター処理できます。

例

例 1: 変数をレターで取得する

このコマンドは、文字 m で始まる名前を持つ変数を取得します。コマンドは、変数の値も取得します。

Get-Variable m*

例 2: 文字で変数の値を取得する

このコマンドは、m で始まる名前を持つ変数の値のみを取得します。

Get-Variable m* -ValueOnly

例 3: 2 文字で変数を取得する

このコマンドは、文字 M または文字 P で始まる変数に関する情報を取得します。

Get-Variable -Include M*,P*

例 4: スコープ別に変数を取得する

最初のコマンドは、ローカルスコープで定義されている変数のみを取得します。に相当 Get-Variable -Scope Local し、省略可能 gv -s 0です。

2 番目のコマンドでは、コマンドレットを Compare-Object 使用して、親スコープ (スコープ 1) で定義されているが、ローカルスコープ (スコープ 0) にのみ表示される変数を検索します。

Get-Variable -Scope 0
Compare-Object (Get-Variable -Scope 0) (Get-Variable -Scope 1)

パラメーター

-Exclude

このコマンドレットが操作から除外する項目の配列を指定します。ワイルドカードを使用できます。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

-Include

コマンドレットが動作する項目の配列を指定します。他の項目はすべて除きます。ワイルドカードを使用できます。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

-Name

変数の名前を指定します。ワイルドカードを使用できます。変数名をパイプ処理することもできます Get-Variable。

Type:	String[]
Position:	0
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	True

-Scope

スコープ内の変数を指定します。このパラメーターに使用できる値は次のとおりです。

グローバル
ローカル
スクリプト
現在のスコープに対する相対的な数値 (0 からスコープの数まで、0 は現在のスコープ、1 はその親)

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

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

-ValueOnly

このコマンドレットが変数の値のみを取得することを示します。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

入力

String

変数名 Get-Variableを含む文字列をパイプ処理できます。

出力

PSVariable

このコマンドレットは、取得する各変数の System.Management.AutomationPSVariable オブジェクトを返します。オブジェクトの型は変数に依存します。

Object[]

ValueOnly パラメーターを指定すると、指定した変数の値がコレクションの場合は、 Get-Variable[System.Object[]]. この動作により、通常のパイプライン操作で変数の値が一度に 1 つずつ処理されなくなります。コレクション列挙を強制する回避策は、コマンドを Get-Variable かっこで囲む方法です。

メモ

このコマンドレットは、環境変数を管理しません。環境変数を管理するには、環境変数プロバイダーを使用します。