Get-Item

構文

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

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

Get-Item
   [-Path] <string[]>
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Force]
   [-Credential <pscredential>]
    [-UseTransaction]
   [-CodeSigningCert]
   [-DocumentEncryptionCert]
   [-SSLServerAuthentication]
   [-DnsName <string>]
   [-Eku <string[]>]
   [-ExpiringInDays <int>]
   [<CommonParameters>]

Get-Item
   -LiteralPath <string[]>
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Force]
   [-Credential <pscredential>]
   [-UseTransaction]
   [-CodeSigningCert]
   [-DocumentEncryptionCert]
   [-SSLServerAuthentication]
   [-DnsName <string>]
   [-Eku <string[]>]
   [-ExpiringInDays <int>]
   [<CommonParameters>]

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

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

説明

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

このコマンドレットは、さまざまな種類のデータ ストア間を移動するために PowerShell プロバイダーによって使用されます。 一部のパラメーターは、特定のプロバイダーでのみ使用できます。 詳細については、「 about_Providers」を参照してください。

例

例 1: 現在のディレクトリを取得する

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

Get-Item .

Directory: C:\

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

例 2: 現在のディレクトリ内のすべての項目を取得する

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

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

例 3: ドライブの現在のディレクトリを取得する

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

Get-Item C:

例 4: 指定したドライブ内の項目を取得する

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

Get-Item C:\*

PowerShell では、従来の*.*ではなく、1 つのアスタリスク (*) を使用してコンテンツを取得します。 形式はリテラルで解釈されるため、 *.* はドットなしでディレクトリやファイル名を取得しません。

例 5: 指定したディレクトリ内のプロパティを取得する

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

(Get-Item C:\Windows).LastAccessTime

例 6: レジストリ キーの内容を表示する

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

Get-Item HKLM:\Software\Microsoft\Powershell\1\Shellids\Microsoft.Powershell\

例 7: 除外があるディレクトリ内の項目を取得する

この例では、ドット (.) を含む名前を持つ Windows ディレクトリ内の項目を取得しますが、 w*で始まっていません。この例は、項目の内容を指定するワイルドカード文字 (*) がパスに含まれている場合にのみ機能します。

Get-Item C:\Windows\*.* -Exclude "w*"

パラメーター

-CodeSigningCert

-Credential

-DnsName

-DocumentEncryptionCert

-Eku

-Exclude

-ExpiringInDays

-Filter

-Force

-Include

-LiteralPath

-Path

-SSLServerAuthentication

-Stream

-UseTransaction

入力

String

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

出力

AliasInfo

コマンドレットは、 Alias: ドライブにアクセスするときにこの種類を出力します。

X509StoreLocation

X509Store

X509Certificate2

コマンドレットは、 Cert: ドライブにアクセスするときにこれらの型を出力します。

DictionaryEntry

コマンドレットは、 Env: ドライブにアクセスするときにこの種類を出力します。

DirectoryInfo

FileInfo

このコマンドレットは、ファイルシステム ドライブにアクセスするときにこれらの型を出力します。

FunctionInfo

FilterInfo

コマンドレットは、 Function: ドライブにアクセスするときにこれらの型を出力します。

RegistryKey

このコマンドレットは、レジストリ ドライブにアクセスするときにこの種類を出力します。

PSVariable

コマンドレットは、 Variable: ドライブにアクセスするときにこの種類を出力します。

WSManConfigContainerElement

WSManConfigLeafElement

コマンドレットは、 WSMan: ドライブにアクセスするときにこれらの型を出力します。

メモ

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

• gi

このコマンドレットは、 Recurse パラメーターを持っていません。これは、その内容ではなく項目のみを取得するためです。 項目の内容を再帰的に取得するには、 Get-ChildItemを使用します。

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

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

関連リンク

• Clear-Item
• Copy-Item
• Invoke-Item
• Move-Item
• New-Item
• Remove-Item
• Rename-Item
• Set-Item
• Get-ChildItem
• Get-ItemProperty
• Get-PSProvider
• about_Providers