英語で読む

次の方法で共有

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

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

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

-Include

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

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

-Name

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

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

-Scope

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

  • Global
  • ローカル
  • スクリプト
  • 現在のスコープに対する相対的な数値 (0 からスコープの数、0 が現在のスコープ、1 がその親)

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

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

-ValueOnly

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

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

入力

String

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

出力

PSVariable

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

Object[]

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

メモ

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

  • すべてのプラットフォーム:

    • gv

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