about_Variable_Provider
プロバイダー名
変数
ドライブ
Variable:
機能
ShouldProcess
簡単な説明
PowerShell 変数とその値へのアクセスを提供します。
詳しい説明
PowerShell Variable プロバイダーを使用すると、現在のコンソールで PowerShell 変数を取得、追加、変更、クリア、および削除できます。
PowerShell Variable プロバイダーは、自動変数、基本設定変数、作成する変数など、PowerShell によって作成される変数をサポートします。
Variable ドライブは、変数オブジェクトのみを含むフラット名前空間です。 変数に子項目はありません。
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:
ドライブ内のデータ ストアを公開します。 変数を操作するには、場所を Variable:
ドライブ (Set-Location Variable:
) に変更するか、他の PowerShell ドライブから作業できます。 別の場所から変数を参照するには、パスでドライブ名 (Variable:
) を使用します。
Set-Location Variable:
ファイル システム ドライブに戻るには、ドライブ名を入力します。 たとえば、次のように入力します。
Set-Location C:
他の PowerShell ドライブから Variable プロバイダーを操作することもできます。 別の場所から変数を参照するには、パスに Variable:
ドライブ名を使用します。
Note
PowerShell ではエイリアスを使用して、プロバイダー パスを使い慣れた方法で操作できます。 dir
やls
などのコマンドが、Get-ChildItem のエイリアスになりました。cd
は、Set-Location のエイリアスです。 pwd
は、Get-Location のエイリアスです。
変数の値の表示
現在のセッションのすべての変数を取得する
このコマンドは現在のセッションのすべての変数とその値の一覧を取得します。 このコマンドは、任意の PowerShell ドライブから使用できます。
Get-ChildItem -Path Variable:
プロバイダー パスを使用して変数を取得する
このコマンドは、ドル記号 ($
) で始まるプロバイダー パスを使用して変数値を取得します。 これは、変数名の前にドル記号 ($
) を付けます。
$variable:home
ワイルドカードを使用して変数を取得する
このコマンドは「max」で始まる名前を持つ変数を取得します。 このコマンドは、任意の PowerShell ドライブから使用できます。
Get-ChildItem -Path Variable:max*
の値を取得します。 変数
このコマンドでは、Get-ChildItem の-LiteralPath
パラメーターを使用して、Variable:
ドライブ内から?
変数の値を取得します。 ?
はパス内のワイルドカードですが、Get-ChildItem
は、-LiteralPath
パラメーターの値のワイルドカードを解決しようとはしません。
Get-ChildItem -Literalpath ?
ReadOnly 変数と定数変数を取得する
このコマンドは、Options プロパティのReadOnly
またはConstant
の値を持つ変数を取得します。
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
コマンドレットを使用して、 a
変数の名前を processes
に変更します。
Rename-Item -Path Variable:a -NewName processes
変数の値を変更する
このコマンドでは、 Set-Item
コマンドレットを使用して、 ErrorActionPreference
変数の値を "Stop" に変更します。
Set-Item -Path Variable:ErrorActionPreference -Value Stop
変数をコピーする
このコマンドでは、 Copy-Item
コマンドレットを使用して、 processes
変数を old_processes
にコピーします。 これにより、processes
変数と同じ値を持つ old_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:
関連項目
PowerShell