Get-Variable
現在のコンソール内の変数を取得します。
構文
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 はその親)
[ローカル] が既定値です。 詳細については、「 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 |
入力
変数名を含む文字列を に Get-Variable
パイプできます。
出力
このコマンドレットは、取得する各変数の System.Management.AutomationPSVariable オブジェクトを返します。 オブジェクトの型は変数に依存します。
Object[]
ValueOnly パラメーターを指定すると、指定した変数の値がコレクションである場合、 Get-Variable
は を[System.Object[]]
返します。 この動作により、通常のパイプライン操作で変数の値が一度に 1 つずつ処理されるのを防ぐことができます。 コレクション列挙を強制する回避策は、コマンドを Get-Variable
かっこで囲む方法です。
メモ
- このコマンドレットは、環境変数を管理しません。 環境変数を管理するには、環境変数プロバイダーを使用します。