Get-ItemProperty
指定した項目のプロパティを取得します。
構文
Get-ItemProperty
[-Path] <String[]>
[[-Name] <String[]>]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
Get-ItemProperty
-LiteralPath <String[]>
[[-Name] <String[]>]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
説明
コマンドレットは Get-ItemProperty
、指定した項目のプロパティを取得します。 たとえば、このコマンドレットを使用して、ファイル オブジェクトの LastAccessTime プロパティの値を取得できます。 このコマンドレットを使用して、レジストリ エントリとその値を表示することもできます。
例
例 1: 特定のディレクトリに関する情報を取得する
このコマンドは、ディレクトリに関する情報を C:\Windows
取得します。
Get-ItemProperty C:\Windows
例 2: 特定のファイルのプロパティを取得する
このコマンドは、ファイルのプロパティを C:\Test\Weather.xls
取得します。 結果はコマンドレットに Format-List
パイプ処理され、出力が一覧として表示されます。
Get-ItemProperty C:\Test\Weather.xls | Format-List
例 3: レジストリ サブキーでレジストリ エントリの値の名前とデータを取得する
このコマンドは、レジストリ サブキー内のレジストリ エントリの ProgramFilesDir
値名とデータを CurrentVersion
取得します。 Path はサブキーを指定し、Name パラメーターはエントリの値名を指定します。
Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion -Name "ProgramFilesDir"
注意
このコマンドでは、 という名前 HKLM:
の PowerShell ドライブがレジストリのハイブに HKEY_LOCAL_MACHINE
マップされている必要があります。
その名前とマッピングを持つドライブは、既定で PowerShell で使用できます。 また、プロバイダー名の後に 2 つのコロンを続けた以下の代替パスを使用して、このレジストリ サブキーのパスを指定することもできます。
Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion
.
例 4: レジストリ キー内のレジストリ エントリの値名とデータを取得する
このコマンドは、レジストリ キー内のレジストリ エントリの値名とデータを PowerShellEngine
取得します。 次のサンプル出力に結果を示します。
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=31bf3856ad364e35, ProcessorArchitecture=msil
PowerShellVersion : 2.0
RuntimeVersion : v2.0.50727
CTPVersion : 5
PSCompatibleVersion : 1.0,2.0
パラメーター
-Credential
注意
このパラメーターは、Windows PowerShell でインストールされるプロバイダーではサポートされていません。 別のユーザーを偽装したり、このコマンドレットの実行時に資格情報を昇格したりするには、 Invoke-Command を使用します。
Type: | PSCredential |
Position: | Named |
Default value: | Current user |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Exclude
文字列配列として、このコマンドレットが操作で除外する項目を指定します。 このパラメーターの値は、Path パラメーターを修飾します。 などのパス要素またはパターンを *.txt
入力します。 ワイルドカード文字を使用できます。 Exclude パラメーターは、コマンドに などのC:\Windows\*
項目の内容が含まれている場合にのみ有効です。ここで、ワイルドカード文字はディレクトリの内容をC:\Windows
指定します。
Type: | String[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Filter
Path パラメーターを修飾するフィルターを指定します。 FileSystem プロバイダーは、フィルターの使用をサポートする唯一のインストール済み PowerShell プロバイダーです。 FileSystem フィルター言語の構文は、about_Wildcardsで確認できます。 フィルターは、取得後に PowerShell でオブジェクトをフィルター処理するのではなく、コマンドレットがオブジェクトを取得するときにプロバイダーによって適用されるため、他のパラメーターよりも効率的です。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Include
文字列配列として、このコマンドレットが操作に含める項目を指定します。 このパラメーターの値は、Path パラメーターを修飾します。 などのパス要素またはパターンを *.txt
入力します。 ワイルドカード文字を使用できます。 Include パラメーターは、コマンドに などのC:\Windows\*
項目の内容が含まれている場合にのみ有効です。ワイルドカード文字はディレクトリの内容をC:\Windows
指定します。
Type: | String[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-LiteralPath
プロパティの現在の場所のパスを指定します。 LiteralPath の値は、型指定されたとおりに使用されます。 ワイルドカードとして解釈される文字はありません。 パスにエスケープ文字が含まれている場合は、単一引用符 ('
) で囲みます。 一重引用符は、文字をエスケープ シーケンスとして解釈しないように PowerShell に指示します。
詳細については、「 about_Quoting_Rules」を参照してください。
Type: | String[] |
Aliases: | PSPath |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
取得するプロパティの名前を 1 つ以上指定します。
Type: | String[] |
Aliases: | PSProperty |
Position: | 1 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
項目のパスを 1 つ以上指定します。
Type: | String[] |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-UseTransaction
アクティブなトランザクションのコマンドが含まれます。 このパラメーターは、トランザクションが進行中の場合のみ有効です。 詳細については、「about_Transactions」を参照してください。
Type: | SwitchParameter |
Aliases: | usetx |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
このコマンドレットへのパスを含む文字列をパイプできます。
出力
このコマンドレットは、取得する各項目プロパティの オブジェクトを返します。 オブジェクトの型は、取得するオブジェクトによって異なります。 たとえば、ファイル システム ドライブでは、ファイルまたはフォルダーが返されます。
メモ
Windows PowerShellには、 の次のエイリアスがGet-ItemProperty
含まれています。
gp
コマンドレットは Get-ItemProperty
、任意のプロバイダーによって公開されるデータを操作するように設計されています。 セッションで使用できるプロバイダーを一覧表示するには、「」と入力します Get-PSProvider
。 詳細については、「about_Providers」を参照してください。
関連リンク
フィードバック
フィードバックの送信と表示