Get-ChildItem

構文

Get-ChildItem
   [[-Path] <string[]>]
   [[-Filter] <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint32>]
   [-Force]
   [-Name]
   [-UseTransaction]
   [-Attributes <FlagsExpression[FileAttributes]>]
   [-Directory]
   [-File]
   [-Hidden]
   [-ReadOnly]
   [-System]
   [<CommonParameters>]

Get-ChildItem
   [[-Filter] <string>]
   -LiteralPath <string[]>
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint>]
   [-Force]
   [-Name]
   [<CommonParameters>]

Get-ChildItem
   [[-Path] <string[]>]
   [[-Filter] <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint>]
   [-Force]
   [-Name]
   [-CodeSigningCert]
   [-DocumentEncryptionCert]
   [-SSLServerAuthentication]
   [-DnsName <string>]
   [-Eku <string[]>]
   [-ExpiringInDays <int>]
   [<CommonParameters>]

Get-ChildItem
   [[-Filter] <string>]
   -LiteralPath <string[]>
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint>]
   [-Force]
   [-Name]
   [-CodeSigningCert]
   [-DocumentEncryptionCert]
   [-SSLServerAuthentication]
   [-DnsName <string>]
   [-Eku <string[]>]
   [-ExpiringInDays <int>]
   [<CommonParameters>]

Get-ChildItem
   [[-Path] <string[]>]
   [[-Filter] <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint>]
   [-Force]
   [-Name]
   [-Attributes <FlagsExpression[FileAttributes]>]
   [-FollowSymlink]
   [-Directory]
   [-File]
   [-Hidden]
   [-ReadOnly]
   [-System]
   [<CommonParameters>]

Get-ChildItem
   [[-Filter] <string>]
   -LiteralPath <string[]>
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint>]
   [-Force]
   [-Name]
   [-Attributes <FlagsExpression[FileAttributes]>]
   [-FollowSymlink]
   [-Directory]
   [-File]
   [-Hidden]
   [-ReadOnly]
   [-System]
   [<CommonParameters>]

説明

Get-ChildItem コマンドレットは、指定された 1 つ以上の場所にある項目を取得します。 項目がコンテナーの場合は、コンテナーの中にある項目 (子項目) を取得します。 Recurse パラメーターを使用すると、すべての子コンテナー内の項目を取得し、Depth パラメーターを使用して再帰するレベルの数を制限できます。

Get-ChildItem は空のディレクトリを表示しません。 Get-ChildItem コマンドに Depth パラメーターまたは Recurse パラメーターが含まれている場合、空のディレクトリは出力に含まれません。

場所は、PowerShell プロバイダーによって Get-ChildItem に公開されます。 場所には、ファイル システム ディレクトリ、レジストリ ハイブ、または証明書ストアを指定できます。 一部のパラメーターは、特定のプロバイダーでのみ使用できます。 詳細については、「 about_Providers」を参照してください。

例

例 1: ファイル システム ディレクトリから子項目を取得する

この例では、ファイル システム ディレクトリから子項目を取得します。 ファイル名とサブディレクトリ名が表示されます。 空の場所の場合、コマンドは出力を返せず、PowerShell プロンプトに戻ります。

Get-ChildItem コマンドレットは、Path パラメーターを使用してディレクトリ C:\Testを指定します。 Get-ChildItem では、PowerShell コンソールにファイルとディレクトリが表示されます。

Get-ChildItem -Path C:\Test

Directory: C:\Test

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----        2/15/2019     08:29                Logs
-a----        2/13/2019     08:55             26 anotherfile.txt
-a----        2/12/2019     15:40         118014 Command.txt
-a----         2/1/2019     08:43            183 CreateTestFile.ps1
-ar---        2/12/2019     14:31             27 ReadOnlyFile.txt

既定では、 Get-ChildItem には、モード (Attributes)、 LastWriteTime、ファイル サイズ (Length)、およびアイテムの Name が一覧表示されます。 Mode プロパティの文字は、次のように解釈できます。

• l (リンク)
• d (ディレクトリ)
• a (アーカイブ)
• r (読み取り専用)
• h (非表示)
• s (システム)

モード フラグの詳細については、「 about_Filesystem_Provider」を参照してください。

例 2: ディレクトリ内の子項目名を取得する

次の使用例は、ディレクトリ内の項目の名前のみを一覧表示します。

Get-ChildItem コマンドレットは、Path パラメーターを使用してディレクトリ C:\Testを指定します。 Name パラメーターは、指定したパスのファイル名またはディレクトリ名のみを返します。 返される名前は、 Path パラメーターの値を基準にしています。

Get-ChildItem -Path C:\Test -Name

Logs
anotherfile.txt
Command.txt
CreateTestFile.ps1
ReadOnlyFile.txt

例 3: 現在のディレクトリとサブディレクトリの子項目を取得する

次の使用例は、現在のディレクトリとそのサブディレクトリにある .txt ファイルを表示します。

Get-ChildItem -Path .\*.txt -Recurse -Force

Directory: C:\Test\Logs\Adirectory

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        2/12/2019     16:16             20 Afile4.txt
-a-h--        2/12/2019     15:52             22 hiddenfile.txt
-a----        2/13/2019     13:26             20 LogFile4.txt

    Directory: C:\Test\Logs\Backup

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        2/12/2019     16:16             20 ATextFile.txt
-a----        2/12/2019     15:50             20 LogFile3.txt

    Directory: C:\Test\Logs

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        2/12/2019     16:16             20 Afile.txt
-a-h--        2/12/2019     15:52             22 hiddenfile.txt
-a----        2/13/2019     13:26             20 LogFile1.txt

    Directory: C:\Test

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        2/13/2019     08:55             26 anotherfile.txt
-a----        2/12/2019     15:40         118014 Command.txt
-a-h--        2/12/2019     15:52             22 hiddenfile.txt
-ar---        2/12/2019     14:31             27 ReadOnlyFile.txt

Get-ChildItem コマンドレットは、Path パラメーターを使用してC:\Test\*.txtを指定します。 Path では、アスタリスク (*) ワイルドカードを使用して、ファイル名拡張子 .txtを持つすべてのファイルを指定します。 Recurse パラメーターは、Directory:の見出しに示すように、Path ディレクトリとそのサブディレクトリを検索します。 Force パラメーターには、h のモードを持つhiddenfile.txtなどの非表示のファイルが表示されます。

例 4: Include パラメーターを使用して子項目を取得する

この例では、 Get-ChildItem Include パラメーターを使用して、 Path パラメーターで指定されたディレクトリから特定の項目を検索します。

# When using the -Include parameter, if you don't include an asterisk in the path
# the command returns no output.
Get-ChildItem -Path C:\Test\ -Include *.txt



Get-ChildItem -Path C:\Test\* -Include *.txt

Directory: C:\Test

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        2/13/2019     08:55             26 anotherfile.txt
-a----        2/12/2019     15:40         118014 Command.txt
-ar---        2/12/2019     14:31             27 ReadOnlyFile.txt

Get-ChildItem コマンドレットは、Path パラメーターを使用してディレクトリ C:\Testを指定します。 Path パラメーターには、ディレクトリの内容を指定する末尾のアスタリスク (*) ワイルドカードが含まれています。 Include パラメーターでは、アスタリスク (*) ワイルドカードを使用して、ファイル名拡張子.txtを持つすべてのファイルを指定します。

Include パラメーターを使用する場合、Path パラメーターには、ディレクトリの内容を指定するために末尾にアスタリスク (*) ワイルドカードが必要です。 たとえば、-Path C:\Test\* のようにします。

• Recurse パラメーターがコマンドに追加された場合、Path パラメーターの末尾のアスタリスク (*) は省略可能です。 Recurse パラメーターは、Path ディレクトリとそのサブディレクトリから項目を取得します。 たとえば、-Path C:\Test\ -Recurse -Include *.txt のように指定します。
• 末尾のアスタリスク (*) が Path パラメーターに含まれていない場合、コマンドは出力を返せず、PowerShell プロンプトに戻ります。 たとえば、-Path C:\Test\ のようにします。

例 5: Exclude パラメーターを使用して子項目を取得する

この例の出力は、ディレクトリ C:\Test\Logsの内容を示しています。 出力は、 Exclude および Recurse パラメーターを使用する他のコマンドのリファレンスです。

Get-ChildItem -Path C:\Test\Logs

Directory: C:\Test\Logs

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----        2/15/2019     13:21                Adirectory
d-----        2/15/2019     08:28                AnEmptyDirectory
d-----        2/15/2019     13:21                Backup
-a----        2/12/2019     16:16             20 Afile.txt
-a----        2/13/2019     13:26             20 LogFile1.txt
-a----        2/12/2019     16:24             23 systemlog1.log

Get-ChildItem -Path C:\Test\Logs\* -Exclude A*

Directory: C:\Test\Logs

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----        2/15/2019     13:21                Backup
-a----        2/13/2019     13:26             20 LogFile1.txt
-a----        2/12/2019     16:24             23 systemlog1.log

Get-ChildItem コマンドレットは、Path パラメーターを使用してディレクトリ C:\Test\Logsを指定します。 Exclude パラメーターは、アスタリスク (*) ワイルドカードを使用して、Aまたはaで始まるファイルまたはディレクトリを出力から除外することを指定します。

Exclude パラメーターを使用する場合、Path パラメーターの末尾のアスタリスク (*) は省略可能です。 たとえば、-Path C:\Test\Logs または -Path C:\Test\Logs\* です。

• 末尾のアスタリスク (*) が Path パラメーターに含まれていない場合は、 Path パラメーターの内容が表示されます。 例外は、 Exclude パラメーターの値と一致するファイル名またはサブディレクトリ名です。
• Path パラメーターに末尾のアスタリスク (*) が含まれている場合、コマンドは Path パラメーターのサブディレクトリに再帰します。 例外は、 Exclude パラメーターの値と一致するファイル名またはサブディレクトリ名です。
• Recurse パラメーターがコマンドに追加された場合、再帰出力は、Path パラメーターに末尾のアスタリスク (*) が含まれているかどうかに関係なく同じです。

例 6: レジストリ ハイブからレジストリ キーを取得する

この例では、 HKEY_LOCAL_MACHINE\HARDWAREからすべてのレジストリ キーを取得します。

Get-ChildItem は、 Path パラメーターを使用してレジストリ キーの HKLM:\HARDWAREを指定します。 PowerShell コンソールには、ハイブのパスと最上位レベルのレジストリ キーが表示されます。

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

Get-ChildItem -Path HKLM:\HARDWARE

Hive: HKEY_LOCAL_MACHINE\HARDWARE

Name             Property
----             --------
ACPI
DESCRIPTION
DEVICEMAP
RESOURCEMAP
UEFI

Get-ChildItem -Path HKLM:\HARDWARE -Exclude D*

Hive: HKEY_LOCAL_MACHINE\HARDWARE

Name                           Property
----                           --------
ACPI
RESOURCEMAP

最初のコマンドは、 HKLM:\HARDWARE レジストリ キーの内容を示します。 Exclude パラメーターは、D*で始まるサブキーを返さないことをGet-ChildItemに指示します。 現在、 Exclude パラメーターは、項目プロパティではなくサブキーでのみ機能します。

例 7: コード署名機関を使用してすべての証明書を取得する

この例では、コード署名機関を持つ PowerShell Cert: ドライブ内の各証明書を取得します。

Get-ChildItem コマンドレットは、Path パラメーターを使用して、Cert: ドライブで証明書プロバイダーを指定します。 Recurse パラメーターは、Path とそのサブディレクトリで指定されたディレクトリを検索します。 CodeSigningCert パラメーターは、コード署名機関を持つ証明書のみを取得します。

Get-ChildItem -Path Cert:\* -Recurse -CodeSigningCert

証明書プロバイダーと Cert: ドライブの詳細については、 about_Certificate_Providerを参照してください。

例 8: Depth パラメーターを使用して項目を取得する

次の使用例は、ディレクトリとそのサブディレクトリ内の項目を表示します。 Depth パラメーターは、再帰に含めるサブディレクトリ レベルの数を決定します。 空のディレクトリは出力から除外されます。

Get-ChildItem -Path C:\Parent -Depth 2

Directory: C:\Parent

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----        2/14/2019     10:24                SubDir_Level1
-a----        2/13/2019     08:55             26 file.txt

    Directory: C:\Parent\SubDir_Level1

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----        2/14/2019     10:24                SubDir_Level2
-a----        2/13/2019     08:55             26 file.txt

    Directory: C:\Parent\SubDir_Level1\SubDir_Level2

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----        2/14/2019     10:22                SubDir_Level3
-a----        2/13/2019     08:55             26 file.txt

Get-ChildItem コマンドレットは、Path パラメーターを使用してC:\Parentを指定します。 Depth パラメーターは、2 レベルの再帰を指定します。 Get-ChildItem には、 Path パラメーターで指定されたディレクトリの内容と、2 つのレベルのサブディレクトリが表示されます。

例 9: ジャンクション ポイントのリンク ターゲットを取得する

Windows コマンド シェルの dir コマンドは、ファイルシステム ジャンクション ポイントのターゲットの場所を示します。 PowerShell では、この情報は、Get-ChildItemによって返されるファイルシステム オブジェクトの Target プロパティから入手できます。

PS D:\> New-Item -ItemType Junction -Name tmp -Target $env:TEMP
PS D:\> Get-ChildItem | Select-Object name,*target

Name     Target
----     ------
tmp      {C:\Users\user1\AppData\Local\Temp}

例 10: AppX 再解析ポイントのリンク ターゲットを取得する

この例では、AppX 再解析ポイントのターゲット情報の取得を試みます。 Microsoft Store アプリケーションは、ユーザーの AppData ディレクトリに AppX 再解析ポイントを作成します。

Get-ChildItem ~\AppData\Local\Microsoft\WindowsApps\MicrosoftEdge.exe |
    Select-Object Mode, LinkTarget, LinkType, Name

Mode  LinkTarget LinkType Name
----  ---------- -------- ----
la---                     MicrosoftEdge.exe

現時点では、Windows は AppX 再解析ポイントのターゲット情報を取得する方法を提供していません。 ファイルシステム オブジェクトの LinkTarget プロパティと LinkType プロパティは空です。

パラメーター

-Attributes

-CodeSigningCert

-Depth

-Directory

-DnsName

-DocumentEncryptionCert

-Eku

-Exclude

-ExpiringInDays

-File

-Filter

-FollowSymlink

-Force

-Hidden

-Include

-LiteralPath

-Name

-Path

-ReadOnly

-Recurse

-SSLServerAuthentication

-System

-UseTransaction

入力

String

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

出力

AliasInfo

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

X509StoreLocation

X509Store

X509Certificate2

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

DictionaryEntry

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

DirectoryInfo

FileInfo

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

FunctionInfo

FilterInfo

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

RegistryKey

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

PSVariable

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

WSManConfigContainerElement

WSManConfigLeafElement

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

String

Name パラメーターを使用すると、このコマンドレットはオブジェクト名を文字列として返します。

メモ

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

• ls
• dir
• gci

Get-ChildItem では、既定では非表示のアイテムは取得されません。 非表示の項目を取得するには、 Force パラメーターを使用します。

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

関連リンク

• about_Certificate_Provider
• about_Providers
• about_Quoting_Rules
• about_Registry_Provider
• ForEach-Object
• Get-Alias
• Get-Item
• Get-Location
• Get-Process
• Get-PSProvider
• Split-Path