Get-Item

Get-Item [-LiteralPath] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-UseTransaction] [<CommonParameters>]

Get-Item [-Path] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-UseTransaction] [<CommonParameters>]

Get-Item コマンドレットは、指定された場所の項目を取得します。ワイルドカード文字 (*) を使用して項目のすべての内容を要求しない限り、指定した場所にある項目の内容は取得されません。

Windows PowerShell の各プロバイダーで Get-Item コマンドレットを使用することで、異なる種類のデータストアの間を移動できるようになります。

-Credential <PSCredential>

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

"User01" や "Domain01\User01" のようなユーザー名を入力するか、Get-Credential コマンドレットで生成されるような PSCredential オブジェクトを入力します。ユーザー名を入力すると、パスワードの入力を促すメッセージが表示されます。

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

必須	false
位置	named
既定値
パイプライン入力を許可する	true (ByPropertyName)
ワイルドカード文字を許可する	false

-Exclude <string[]>

指定した項目を除外します。このパラメーターの値は、Path パラメーターを修飾します。"*.txt" などのパス要素またはパターンを入力します。ワイルドカードを使用できます。

Exclude パラメーターは、C:\Windows\* のように、コマンドに項目の内容が含まれている場合のみ有効です。この場合、ワイルドカード文字は C:\Windows ディレクトリの内容を示します。

必須	false
位置	named
既定値
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

-Filter <string>

プロバイダーの形式や言語でフィルターを指定します。このパラメーターの値は、Path パラメーターを修飾します。ワイルドカードを使用できるかどうかなど、フィルターの構文はプロバイダーによって異なります。フィルターは他のパラメーターよりも効率が良い方法です。これは、オブジェクトを取得した後に Windows PowerShell がオブジェクトをフィルターするのではなく、オブジェクトを取得する際にプロバイダーがフィルターを適用するためです。

必須	false
位置	named
既定値
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

-Force

非表示の項目など、設定しないとアクセスできない項目をコマンドレットで取得できるようにします。実装はプロバイダーごとに異なります。詳細については、「about_Providers」を参照してください。Force パラメーターを使用しても、コマンドレットはセキュリティ制限を上書きできません。

必須	false
位置	named
既定値
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

-Include <string[]>

指定した項目だけを取得します。このパラメーターの値は、Path パラメーターを修飾します。"*.txt" などのパス要素またはパターンを入力します。ワイルドカードを使用できます。

Include パラメーターは、C:\Windows\* のように、コマンドに項目の内容が含まれている場合のみ有効です。この場合、ワイルドカード文字は C:\Windows ディレクトリの内容を示します。

必須	false
位置	named
既定値
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

-LiteralPath <string[]>

項目のパスを指定します。Path と異なり、LiteralPath の値は入力したとおりに使用されます。ワイルドカードとして解釈される文字はありません。パスにエスケープ文字が含まれている場合は、単一引用符で囲みます。単一引用符で囲んだ文字はエスケープシーケンスとして解釈されません。

必須	true
位置	1
既定値
パイプライン入力を許可する	true (ByPropertyName)
ワイルドカード文字を許可する	false

-Path <string[]>

項目のパスを指定します。Get-Item は指定された場所にある項目を取得します。ワイルドカードを使用できます。このパラメーターは必須ですが、パラメーター名 (Path) は省略可能です。

ドット (.) を使用して現在の場所を指定します。現在の場所にあるすべての項目を指定するには、ワイルドカード文字 (*) を使用します。

必須	true
位置	1
既定値
パイプライン入力を許可する	true (ByValue, ByPropertyName)
ワイルドカード文字を許可する	false

-UseTransaction

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

必須	false
位置	named
既定値
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

<CommonParameters>

このコマンドレットは、次の共通パラメーターをサポートします: -Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、および -OutVariable。Ô”¼š¤Ë¤Ä¤¤¤Æ¤Ï¡¢次を参照してください: about_Commonparameters.

入力値の型は、コマンドレットへのパイプが可能なオブジェクトの型です。戻り値の型は、コマンドレットによって返されるオブジェクトの型です。

入力

System.String

パイプを使用してパスを含む文字列を Get-Item に渡すことができます。

出力

Object

Get-Item は、取得するオブジェクトを返します。この型は、パス内のオブジェクトの型によって決まります。

Get-Item は、その組み込みエイリアスである "gi" で参照することもできます。詳細については、「about_Aliases」を参照してください。

Get-Item は項目のみを取得し、その内容は取得しません。したがって、Recurse パラメーターがありません。項目の内容を再帰的に取得するには、Get-ChildItem を使用します。

レジストリ内を移動するには、Get-Item を使用してレジストリキーを取得し、Get-ItemProperty を使用してレジストリ値とデータを取得します。レジストリ値はレジストリキーのプロパティと見なされます。

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

C:\PS>get-item .

Directory: C:\

Mode                LastWriteTime     Length Name
----                -------------     ------ ----
d----         7/26/2006  10:01 AM            ps-test

説明
-----------
このコマンドは、現在のディレクトリを取得します。ドット (.) は、現在の場所にある項目を表します (内容ではありません)。

C:\PS>get-item *

Directory: C:\ps-test

Mode                LastWriteTime     Length Name
----                -------------     ------ ----
d----         7/26/2006   9:29 AM            Logs
d----         7/26/2006   9:26 AM            Recs
-a---         7/26/2006   9:28 AM         80 date.csv
-a---         7/26/2006  10:01 AM         30 filenoext
-a---         7/26/2006   9:30 AM      11472 process.doc
-a---         7/14/2006  10:47 AM         30 test.txt

説明
-----------
このコマンドは、現在のディレクトリ内のすべての項目を取得します。ワイルドカード文字 (*) は、現在の項目のすべての内容を表します。

C:\PS>get-item C:\

説明
-----------
このコマンドは、C: ドライブの現在のディレクトリを取得します。ここで取得するオブジェクトは、ディレクトリのみを表します。その内容は表しません。

C:\PS>get-item C:\*

説明
-----------
このコマンドは、C: ドライブ中の項目を取得します。ワイルドカード文字 (*) は、コンテナーだけでなく、コンテナー内のすべての項目を表します。

Windows PowerShell では、従来の *.* ではなく、単一のアスタリスク (*) を使用して内容を取得します。形式は文字どおりに解釈されるため、*.* を使用すると、名前にドットが含まれていないディレクトリやファイルは取得されません。

C:\PS>(get-item C:\Windows).LastAccessTime

説明
-----------
このコマンドは、C:\Windows ディレクトリの LastAccessTime プロパティを取得します。LastAccessTime は、ファイル システム ディレクトリの 1 つのプロパティにすぎません。ディレクトリのすべてのプロパティを参照するには、「(Get-Item <directory-name>) | Get-Member」と入力します。

C:\PS>get-item hklm:\software\microsoft\powershell\1\shellids\microsoft.powershell\*

説明
-----------
このコマンドを実行すると、Microsoft.PowerShell レジストリ キーの内容が表示されます。Windows PowerShell Registry プロバイダーでは、Get-Item を使用してレジストリ キーとサブキーを取得できますが、レジストリ値とデータを取得するには、Get-ItemProperty を使用する必要があります。

C:\PS>get-item c:\Windows\* -include *.* -exclude w*

説明
-----------
このコマンドを実行すると、Windows ディレクトリ内の項目のうち、名前にドット (.) が含まれ、先頭が w* でないものが取得されます。このコマンドは、パスにワイルドカード文字 (*) が含まれ、項目の内容が指定されている場合にだけ有効です。