about_Variable_Provider

  • [アーティクル]

プロバイダー名

変数

ドライブ

Variable:

機能

ShouldProcess

簡単な説明

PowerShell 変数とその値へのアクセスを提供します。

詳しい説明

PowerShell 変数 プロバイダーを使用すると、現在のコンソールで PowerShell 変数を取得、追加、変更、クリア、および削除できます。

PowerShell 変数 プロバイダーでは、PowerShell によって作成される変数 (自動変数、基本設定変数、作成する変数など) がサポートされます。

変数ドライブは、変数オブジェクトのみを含むフラット名前空間です。 変数に子項目はありません。

Variable プロバイダーは、この記事で説明する次のコマンドレットをサポートしています。

PowerShell には、特に変数を表示および変更するために設計された一連のコマンドレットも含まれています。 Variable コマンドレットを使用する場合は、名前にドライブをVariable:指定する必要はありません。 この記事では、Variable コマンドレットの操作については説明しません。

Note

PowerShell 式パーサーを使用して、コマンドレットを使用せずに変数の値を作成、表示、変更することもできます。 変数を直接操作する場合は、ドル記号 ($) を使用して名前を変数として識別し、代入演算子 (=)を使用してその値を確立および変更します。 たとえば、 $p = Get-Process 変数を p 作成し、その中にコマンドの結果を Get-Process 格納します。

このプロバイダーによって公開される型

変数には、いくつかの異なる型のいずれかを指定できます。 ほとんどの変数はクラスの PSVariable インスタンスになります。 その他の変数とその型を次に示します。

  • 変数は ? クラスの QuestionMarkVariable インスタンスです。
  • 変数は null クラスの NullVariable インスタンスです。
  • 最大カウント変数は、クラスの SessionStateCapacityVariable インスタンスです。
  • LocalVariable インスタンスには、次のような現在の実行に関する情報が含まれています。
    • MyInvocation
    • PSCommandPath
    • PSScriptRoot
    • PSBoundParameters
    • args
    • input

Variable プロバイダーは、ドライブ内のデータ ストアをVariable:公開します。 変数を操作するには、場所をドライブ (Set-Location Variable:) にVariable:変更するか、他の PowerShell ドライブから作業できます。 別の場所から変数を参照するには、パスでドライブ名 (Variable:) を使用します。

Set-Location Variable:

ファイル システム ドライブに戻るには、ドライブ名を入力します。 たとえば、次のように入力します。

Set-Location C:

他の PowerShell ドライブから Variable プロバイダーを操作することもできます。 別の場所から変数を参照するには、パスでドライブ名 Variable: を使用します。

Note

PowerShell ではエイリアスを使用して、プロバイダー パスを使い慣れた方法で操作できます。 Get-ChildItem のエイリアスなどのdirコマンドはls、 cd Set-Location のエイリアスです。 は pwd Get-Location の エイリアスです。

変数の値の表示

現在のセッションのすべての変数を取得する

このコマンドは現在のセッションのすべての変数とその値の一覧を取得します。 このコマンドは、任意の PowerShell ドライブから使用できます。

Get-ChildItem -Path Variable:

プロバイダー パスを使用して変数を取得する

このコマンドは、ドル記号 ($) で始まるプロバイダー パスを使用して変数値を取得します。 これは、変数名の前にドル記号 ($) を付けと同じ効果を持ちます。

$variable:home

ワイルドカードを使用して変数を取得する

このコマンドは「max」で始まる名前を持つ変数を取得します。 このコマンドは、任意の PowerShell ドライブから使用できます。

Get-ChildItem -Path Variable:max*

の値を取得します。 変数

このコマンドでは、-LiteralPathGet-ChildItem のパラメーターを使用して、ドライブ内から変数の?値をVariable:取得します。 これは?パス内のワイルドカードですがGet-ChildItem、パラメーターの値に含まれる野生の-LiteralPathカードを解決しようとはしません。

Get-ChildItem -Literalpath ?

ReadOnly 変数と定数変数を取得する

このコマンドは、Options プロパティの値を持つ変数または Constant Options プロパティのReadOnly変数を取得します。

Get-ChildItem -Path Variable: | Where-Object {
   $_.options -Match "Constant" `
   -or $_.options -Match "ReadOnly"
 } | Format-List -Property name, value, options

変数の作成

新しい変数を作成する

このコマンドは変数を services 作成し、その中にコマンドの結果を Get-Service 格納します。 現在の場所はドライブ内 Variable: にあるため、パラメーターの値は現在の -Path 場所を表すドット (.) です。

コマンドのかっこを Get-Service 使用すると、変数が作成される前にコマンドが実行されます。 かっこを使用しない場合、新しい変数の値は "Get-Service" 文字列です。

New-Item -Path . -Name services -Value (Get-Service)

絶対パスを使用して変数を作成する

このコマンドは変数を services 作成し、その中にコマンドの結果を Get-Service 格納します。

New-Item -Path Variable:services -Value Get-Service

値なしで変数を作成するには、代入演算子を省略します。

変数の変更

変数名の変更

このコマンドは、コマンドレットをRename-Item使用して変数processesの名前を a .

Rename-Item -Path Variable:a -NewName processes

変数の値を変更する

このコマンドでは、コマンドレットを Set-Item 使用して変数の値を ErrorActionPreference "Stop" に変更します。

Set-Item -Path Variable:ErrorActionPreference -Value Stop

変数をコピーする

このコマンドでは、コマンドレットを Copy-Item 使用して変数を processes コピーします old_processes。 これにより、変数と同じ値を持つ名前 old_processes の新しい変数が processes 作成されます。

Copy-Item -Path Variable:processes -Destination Variable:old_processes

変数の削除

このコマンドは、現在の serv セッションから変数を削除します。 このコマンドは、任意の PowerShell ドライブで使用できます。

Remove-Variable -Path Variable:serv

-Force パラメーターを使用して変数を削除する

このコマンドは、Options プロパティの値が の変数を除き、現在のConstantセッションからすべての変数を削除します。 パラメーターを -Force 指定しないと 、Options プロパティの値 ReadOnlyが .

Remove-Item Variable:* -Force

変数の値を NULL に設定する

このコマンドは、コマンドレットを Clear-Item 使用して変数の値を processes NULL に変更します。

Clear-Item -Path Variable:processes

パイプラインの使用

プロバイダー コマンドレットは、パイプライン入力を受け入れます。 パイプラインを使用すると、あるコマンドレットから別のプロバイダー コマンドレットにプロバイダー データを送信することで、タスクを簡略化できます。 プロバイダー コマンドレットでパイプラインを使用する方法の詳細については、この記事全体で提供されているコマンドレットリファレンスを参照してください。

ヘルプの表示

Windows PowerShell 3.0 より、プロバイダー コマンドレットのためにカスタマイズされたヘルプ トピックを取得できます。これはファイル システム ドライブでのプロバイダー コマンドレットの動作を説明します。

ファイル システム ドライブ用にカスタマイズされたヘルプ トピックを取得するには、ファイル システム ドライブで Get-Help コマンドを実行するか、Get-Help のパラメーターを使用-Pathしてファイル システム ドライブを指定します。

Get-Help Get-ChildItem

Get-Help Get-ChildItem -Path variable:

関連項目