Get-Variable
現在のコンソールの変数を取得します。
構文
Default (既定)
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
このコマンドレットが操作から除外する項目の配列を指定します。 ワイルドカードを使用できます。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | True |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Include
コマンドレットが動作する項目の配列を指定します。他の項目はすべて除きます。 ワイルドカードを使用できます。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | True |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
変数の名前を指定します。
ワイルドカードを使用できます。
変数名を Get-Variable にパイプすることもできます。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | True |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Scope
スコープ内の変数を指定します。このパラメーターに使用できる値は次のとおりです。
- グローバル
- ローカル
- スクリプト
- 現在のスコープに対する相対的な数値（スコープ数は0から始まり、0は現在のスコープ、1はその親スコープを表します）
ローカル が既定値です。 詳細については、about_Scopesを参照してください。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ValueOnly
このコマンドレットが変数の値のみを取得することを示します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
入力
String
変数名を含む文字列をこのコマンドレットにパイプできます。
出力
PSVariable
既定では、このコマンドレットは、取得する各変数の AutomationPSVariable オブジェクトを返します。 オブジェクト型は変数によって異なります。
Object
ValueOnly パラメーターを指定し、指定した変数の値がコレクションである場合、このコマンドレットは [System.Object[]]を返します。 この動作により、通常のパイプライン操作で変数の値が一度に 1 つずつ処理されるのを防ぐことができます。 コレクション列挙を強制する回避策は、Get-Variable コマンドをかっこで囲む方法です。
メモ
PowerShell には、Get-Variableの次のエイリアスが含まれています。
すべてのプラットフォーム:
gv
このコマンドレットは環境変数を管理しません。 環境変数を管理するには、環境プロバイダーを使用します。
