次の方法で共有

Get-ItemProperty

  • リファレンス
モジュール:
Microsoft.PowerShell.Management

指定した項目のプロパティを取得します。

構文

Get-ItemProperty
   [-Path] <String[]>
   [[-Name] <String[]>]
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-ItemProperty
   -LiteralPath <String[]>
   [[-Name] <String[]>]
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Credential <PSCredential>]
   [<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: レジストリ サブキーのレジストリ エントリの値の名前とデータを取得する

このコマンドは、CurrentVersion レジストリ サブキーの ProgramFilesDir レジストリ エントリの値の名前とデータを取得します。 Path はサブキーを指定し、Name パラメーターはエントリの値名を指定します。

Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion -Name "ProgramFilesDir"

手記

このコマンドを実行するには、レジストリの HKEY_LOCAL_MACHINE ハイブにマップされる HKLM: という名前の PowerShell ドライブが必要です。

その名前とマッピングを持つドライブは、既定で 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

手記

このパラメーターは、PowerShell でインストールされているプロバイダーではサポートされていません。 別のユーザーを偽装したり、このコマンドレットの実行時に資格情報を昇格したりするには、Invoke-Commandを使用します。

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

-Exclude

文字列配列として、このコマンドレットが操作で除外する項目を指定します。 このパラメーターの値は、Path パラメーターを修飾します。 パス要素またはパターン (*.txtなど) を入力します。 ワイルドカード文字を使用できます。 Exclude パラメーターは、コマンドに項目の内容 (C:\Windows\*など) が含まれている場合にのみ有効です。ワイルドカード文字は、C:\Windows ディレクトリの内容を指定します。

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

-Filter

Path パラメーターを修飾するフィルターを指定します。 FileSystem プロバイダーは、フィルターの使用をサポートする唯一のインストール済み PowerShell プロバイダーです。 FileSystem フィルター言語の構文は、about_Wildcardsにあります。 フィルターは、取得後に PowerShell でオブジェクトをフィルター処理するのではなく、コマンドレットがオブジェクトを取得するときにプロバイダーによって適用されるため、他のパラメーターよりも効率的です。

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

-Include

文字列配列として、このコマンドレットが操作に含める項目を指定します。 このパラメーターの値は、Path パラメーターを修飾します。 パス要素またはパターン (*.txtなど) を入力します。 ワイルドカード文字を使用できます。 Include パラメーターは、コマンドに項目の内容 (ワイルドカード文字が C:\Windows ディレクトリの内容を指定する C:\Windows\*など) が含まれている場合にのみ有効です。

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

-LiteralPath

1 つ以上の場所へのパスを指定します。 LiteralPath の値は、型指定されたとおりに使用されます。 ワイルドカードとして解釈される文字はありません。 パスにエスケープ文字が含まれている場合は、単一引用符で囲みます。 単一引用符は、エスケープ シーケンスとして文字を解釈しないように PowerShell に指示します。

詳細については、about_Quoting_Rulesを参照してください。

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

-Name

取得するプロパティの名前を指定します。 ワイルドカード文字を使用できます。

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

-Path

項目または項目へのパスを指定します。 ワイルドカード文字を使用できます。

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

入力

String

このコマンドレットへのパスを含む文字列をパイプ処理できます。

出力

Boolean

String

DateTime

FileInfo

DirectoryInfo

このコマンドレットは、取得する各アイテム プロパティのオブジェクトを返します。 オブジェクトの種類は、取得されるオブジェクトによって異なります。 たとえば、ファイル システム ドライブでは、ファイルまたはフォルダーが返される場合があります。

メモ

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

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

Get-ItemProperty コマンドレットは、任意のプロバイダーによって公開されるデータを操作するように設計されています。 セッションで使用可能なプロバイダーを一覧表示するには、「Get-PSProvider」と入力します。 詳細については、about_Providersを参照してください。