Get-ItemProperty

Get-ItemProperty [-LiteralPath] <string[]> [[-Name] <string[]>] [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Include <string[]>] [-UseTransaction] [<CommonParameters>]

Get-ItemProperty [-Path] <string[]> [[-Name] <string[]>] [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Include <string[]>] [-UseTransaction] [<CommonParameters>]

C:\PS>get-itemproperty C:\Windows

説明
-----------
このコマンドは、C:\Windows ディレクトリに関する情報を取得します。

C:\PS>get-itemproperty C:\Test\Weather.xls | format-list

説明
-----------
このコマンドは、C:\Test\Weather.xls ファイルのプロパティを取得します。結果は Format-List コマンドレットに対してパイプ処理され、一覧として表示されます。

C:\PS>get-itemproperty -path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion

説明
-----------
このコマンドを実行すると、レジストリ サブキー CurrentVersion に含まれている各レジストリ エントリの値名とデータが表示されます。このコマンドを実行するには、HKLM: という名前の Windows PowerShell ドライブがレジストリの HKEY_LOCAL_MACHINE ハイブにマッピングされている必要があります。この名前とマッピングを持つドライブは、Windows PowerShell では既定で使用可能です。また、プロバイダー名の後に 2 つのコロンを続けた以下の代替パスを使用して、このレジストリ サブキーのパスを指定することもできます。
Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion.

C:\PS>get-itemproperty -path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion `
-name "ProgramFilesDir"

説明
-----------
このコマンドは、レジストリ サブキー CurrentVersion に含まれているレジストリ エントリ ProgramFilesDir の値名とデータを取得します。また、Path パラメーターを使用してサブキーを、Name パラメーターを使用してエントリの値名を指定します。

C:\PS>get-itemproperty -path HKLM:\SOFTWARE\Microsoft\PowerShell\1\PowerShellEngine

ApplicationBase         : C:\Windows\system32\WindowsPowerShell\v1.0\
ConsoleHostAssemblyName : Microsoft.PowerShell.ConsoleHost, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad
                          364e35, ProcessorArchitecture=msil
PowerShellVersion       : 2.0
RuntimeVersion          : v2.0.50727
CTPVersion              : 5
PSCompatibleVersion     : 1.0,2.0

説明
-----------
このコマンドは、PowerShellEngine レジストリ キー内のレジストリ エントリの値名とデータを取得します。次のサンプル出力に結果を示します。

C:\PS>get-itemproperty -path HKLM:\SOFTWARE\Microsoft\PowerShell\1\ShellIds\Microsoft.PowerShell

Path                                                        ExecutionPolicy
----                                                        ---------------
C:\Windows\system32\WindowsPowerShell\v1.0\powershell.exe   RemoteSigned


C:\PS>get-itemproperty -path HKLM:\SOFTWARE\Microsoft\PowerShell\1\ShellIds\Microsoft.PowerShell | format-list -property *

PSPath          : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\Software\Microsoft\PowerShell\1\ShellIds\Micro
                  soft.PowerShell
PSParentPath    : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\Software\Microsoft\PowerShell\1\ShellIds
PSChildName     : Microsoft.PowerShell
PSDrive         : HKLM
PSProvider      : Microsoft.PowerShell.Core\Registry
Path            : C:\Windows\system32\WindowsPowerShell\v1.0\powershell.exe
ExecutionPolicy : RemoteSigned

説明DO NOT TRANSLATE
-----------
この例は、レジストリ値とデータ、および結果の解釈方法が見やすくなるように Get-ItemProperty コマンドの出力を一覧形式に書式設定する方法を示します。

最初のコマンドは、Get-ItemProperty コマンドレットを使用して Microsoft.PowerShell サブキーのレジストリ エントリを取得します。このサブキーには、Windows PowerShell の既定のシェルのオプションが格納されています。次のサンプル出力に結果を示します。

出力には、Path と ExecutionPolicy の 2 つのレジストリ エントリがあることが示されます。レジストリ キーに含まれるエントリが 5 つよりも少ない場合、既定では表形式で表示されますが、一覧に表示した方がわかりやすい場合が多々あります。

2 番目のコマンドも、同じ Get-ItemProperty コマンドレットを使用します。ただし、このコマンドではパイプライン演算子 (|) を使用してコマンドの結果を Format-List コマンドレットに送ります。Format-List コマンドは Property パラメーターに * (すべての値) を指定して、オブジェクトのすべてのプロパティを一覧に表示します。次のサンプル出力に結果を示します。

結果には、レジストリ キー オブジェクトのあまり知られていないいくつかのプロパティと共に Path および ExecutionPolicy レジストリ エントリが表示されます。プレフィックス "PS" の付いたその他のプロパティは、レジストリ キーを表すオブジェクトのように Windows PowerShell カスタム オブジェクトのプロパティです。