Get-ItemPropertyValue

モジュール:: Microsoft.PowerShell.Management

指定した項目の 1 つ以上のプロパティの値を取得します。

構文

Get-ItemPropertyValue
   [[-Path] <String[]>]
   [-Name] <String[]>
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Credential <PSCredential>]
   [-UseTransaction]
   [<CommonParameters>]

Get-ItemPropertyValue
   -LiteralPath <String[]>
   [-Name] <String[]>
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Credential <PSCredential>]
   [-UseTransaction]
   [<CommonParameters>]

説明

Get-ItemPropertyValue は、Name パラメーターを使用して指定するプロパティの現在の値を取得します。この値は、Path または LiteralPath パラメーターで指定するパスにあります。

例

例 1: ProductID プロパティの値を取得する

このコマンドは、Windows レジストリプロバイダーの "\SOFTWARE\Microsoft\Windows NT\CurrentVersion" オブジェクトの ProductID プロパティの値を取得します。

Get-ItemPropertyValue HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion -Name ProductID

94253-50000-11141-AA785

例 2: ファイルまたはフォルダーの最後の書き込み時刻を取得する

このコマンドは、FileSystem プロバイダーで動作する "C:\Users\Test\Documents\ModuleToAssembly" フォルダーから 、LastWriteTime プロパティの値、またはファイルまたはフォルダーが最後に変更された時刻を取得します。

Get-ItemPropertyValue -Path C:\Users\Test\Documents\ModuleToAssembly -Name LastWriteTime

Wednesday, September 3, 2014 2:53:22 PM

例 3: ファイルまたはフォルダーの複数のプロパティ値を取得する

このコマンドは、フォルダーの LastWriteTime、CreationTime、および ルート プロパティの値を取得します。プロパティ値は、プロパティ名を指定した順序で返されます。

Get-ItemPropertyValue -Path C:\Users\Test\Documents\ModuleToAssembly -Name LastWriteTime,CreationTime,Root

Wednesday, September 3, 2014 2:53:22 PM
Wednesday, September 3, 2014 2:53:10 PM

Name              : C:\
Parent            :
Exists            : True
Root              : C:\
FullName          : C:\
Extension         :
CreationTime      : 9/1/2014 4:59:45 AM
CreationTimeUtc   : 9/1/2014 11:59:45 AM
LastAccessTime    : 9/27/2014 5:22:02 PM
LastAccessTimeUtc : 9/28/2014 12:22:02 AM
LastWriteTime     : 9/27/2014 5:22:02 PM
LastWriteTimeUtc  : 9/28/2014 12:22:02 AM
Attributes        : Hidden, System, Directory
BaseName          : C:\
Target            :
LinkType          :
Mode              : d--hs-

パラメーター

-Credential

このアクションを実行するアクセス許可を持つユーザーアカウントを指定します。既定値は現在のユーザーです。

"User01" や "Domain01\User01" などのユーザー名を入力するか、PSCredential オブジェクト (Get-Credential コマンドレットによって生成されたものなど) を入力します。ユーザー名を入力すると、パスワードの入力を求められます。

Warnung

このパラメーターは、Windows PowerShell でインストールされているプロバイダーではサポートされていません。

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

-Exclude

文字列配列として、このコマンドレットが操作から除外する項目を指定します。このパラメーターの値は、Path パラメーターを修飾します。 "*.txt" などのパス要素またはパターンを入力します。ワイルドカード文字を使用できます。

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

-Filter

プロバイダーの形式または言語でフィルターを指定します。このパラメーターの値は、Path パラメーターを修飾します。

ワイルドカード文字の使用を含むフィルターの構文は、プロバイダーによって異なります。フィルターは、取得後に PowerShell でオブジェクトをフィルター処理するのではなく、コマンドレットがオブジェクトを取得するときにプロバイダーによって適用されるため、他のパラメーターよりも効率的です。

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

-Include

文字列配列として、このコマンドレットが操作に含める項目を指定します。このパラメーターの値は、Path パラメーターを修飾します。 "*.txt" などのパス要素またはパターンを入力します。ワイルドカード文字を使用できます。

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

-LiteralPath

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

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

-Name

取得するプロパティの名前を指定します。

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

-Path

項目または項目へのパスを指定します。

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

-UseTransaction

アクティブなトランザクションにコマンドを含みます。このパラメーターは、トランザクションが進行中の場合にのみ有効です。詳細については、「about_Transactions」を参照してください。

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

入力

String

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

出力

System.Boolean, System.String, System.DateTime

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

メモ

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