Get-ChildItem

リファレンス

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

1 つ以上の指定された場所から項目および子項目を取得します。

構文

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

Note

このパラメーターは、 FileSystem プロバイダーでのみ使用できます。

指定した属性のファイルとフォルダーを取得します。このパラメーターはすべての属性をサポートします。複雑な属性の組み合わせを指定できます。

たとえば、暗号化または圧縮されたシステム以外のファイル (ディレクトリではない) を取得するには、次のように入力します。

Get-ChildItem -Attributes !Directory+!System+Encrypted, !Directory+!System+Compressed

よく使用される属性を持つファイルとフォルダーを検索するには、 Attributes パラメーターを使用します。または、パラメーター Directory、 File、 Hidden、 ReadOnly、および System。

Attributes パラメーターは、次のプロパティをサポートしています。

アーカイブ
Compressed
Device
ディレクトリ
Encrypted
非表示
IntegrityStream
Normal
NoScrubData
NotContentIndexed
オフライン
ReadOnly
ReparsePoint
SparseFile
システム
一時

これらの属性の詳細については、 FileAttributes 列挙型を参照してください。

属性を結合するには、次の演算子を使用します。

! (NOT)
+ (AND)
, (OR)

演算子とその属性の間にスペースを使用しないでください。スペースはコンマの後に指定できます。

一般的な属性の場合は、次の省略形を使用します。

D (ディレクトリ)
H (非表示)
R (読み取り専用)
S (システム)

型:	FlagsExpression<T>[FileAttributes]
指定可能な値:	Archive, Compressed, Device, Directory, Encrypted, Hidden, IntegrityStream, Normal, NoScrubData, NotContentIndexed, Offline, ReadOnly, ReparsePoint, SparseFile, System, Temporary
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CodeSigningCert

Note

このパラメーターは、 Certificate プロバイダーでのみ使用できます。

EnhancedKeyUsageList プロパティ値にCode Signing証明書の一覧を取得するには、CodeSigningCert パラメーターを使用します。

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

-Depth

このパラメーターは PowerShell 5.0 で追加され、再帰の深さを制御できます。既定では、 Get-ChildItem は親ディレクトリの内容を表示します。 Depth パラメーターは、再帰に含まれるサブディレクトリレベルの数を決定し、内容を表示します。

たとえば、 -Depth 2 には、 Path パラメーターのディレクトリ、第 1 レベルのサブディレクトリ、および第 2 レベルのサブディレクトリが含まれます。既定では、ディレクトリ名とファイル名が出力に含まれます。

Note

PowerShell または cmd.exe の Windows コンピューターでは、 tree.com コマンドを使用してディレクトリ構造のグラフィカルビューを表示できます。

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

-Directory

Note

このパラメーターは、 FileSystem プロバイダーでのみ使用できます。

ディレクトリの一覧を取得するには、 Directory パラメーターまたは Attributes パラメーターと Directory プロパティを使用します。 Recurse パラメーターは、Directoryで使用できます。

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

-DnsName

Note

このパラメーターは、 Certificate プロバイダーでのみ使用できます。

コマンドレットが取得する証明書の DNSNameList プロパティと一致するドメイン名または名前パターンを指定します。このパラメーターの値は、 Unicode または ASCIIにすることができます。 Punycode 値は Unicode に変換されます。ワイルドカード文字 (*) を使用できます。

このパラメーターは PowerShell 7.1 で再導入されました

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

-DocumentEncryptionCert

Note

このパラメーターは、 Certificate プロバイダーでのみ使用できます。

EnhancedKeyUsageList プロパティ値にDocument Encryption証明書の一覧を取得するには、DocumentEncryptionCert パラメーターを使用します。

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

-Eku

Note

このパラメーターは、 Certificate プロバイダーでのみ使用できます。

コマンドレットが取得する証明書の EnhancedKeyUsageList プロパティと一致するテキストまたはテキストパターンを指定します。ワイルドカード文字 (*) を使用できます。 EnhancedKeyUsageList プロパティには、EKU のフレンドリ名と OID フィールドが含まれます。

このパラメーターは PowerShell 7.1 で再導入されました

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

-Exclude

コマンドレットが子項目を取得する際に一致する 1 つ以上の文字列パターンの配列を指定します。一致する項目はすべて出力から除外されます。 *.txtやA*などのパス要素またはパターンを入力します。ワイルドカード文字を使用できます。

Path パラメーターの末尾のアスタリスク (*) は省略可能です。たとえば、-Path C:\Test\Logs または -Path C:\Test\Logs\* です。末尾のアスタリスク (*) が含まれている場合、コマンドは Path パラメーターのサブディレクトリに再帰します。アスタリスク (*) を指定しないと、 Path パラメーターの内容が表示されます。詳細については、例 5 と「メモ」セクションを参照してください。

Include パラメーターと Exclude パラメーターを一緒に使用できます。ただし、除外は包含の後に適用され、最終的な出力に影響を与える可能性があります。

Note

Includeパラメーターと Exclude パラメーターは、LiteralPath パラメーターと共に使用しても無効です。これは PowerShell 7 で修正されています。

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

-ExpiringInDays

Note

このパラメーターは、 Certificate プロバイダーでのみ使用できます。

コマンドレットは、指定した日数以前に期限切れになっている証明書のみを返すように指定します。値 0 (0) は、有効期限が切れた証明書を取得します。

このパラメーターは PowerShell 7.1 で再導入されました

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

-File

Note

このパラメーターは、 FileSystem プロバイダーでのみ使用できます。

ファイルの一覧を取得するには、 File パラメーターを使用します。 Recurse パラメーターは、Fileと共に使用できます。

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

-Filter

Path パラメーターを修飾するフィルターを指定します。 FileSystem プロバイダーは、フィルターをサポートする唯一のインストール済み PowerShell プロバイダーです。フィルターは、他のパラメーターよりも効率的です。プロバイダーは、取得後に PowerShell でオブジェクトをフィルター処理するのではなく、コマンドレットがオブジェクトを取得するときにフィルターを適用します。ファイルを列挙するために、フィルター文字列が .NET API に渡されます。 API では、 * と ? ワイルドカードのみがサポートされます。

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

-FollowSymlink

Note

このパラメーターは、 FileSystem プロバイダーでのみ使用できます。

既定では、 Get-ChildItem コマンドレットは、再帰中に見つかったディレクトリへのシンボリックリンクを表示しますが、再帰は行いません。 FollowSymlink パラメーターを使用して、これらのシンボリックリンクを対象とするディレクトリを検索します。 FollowSymlink は動的パラメーターであり、FileSystem プロバイダーでのみサポートされます。

このパラメーターは、PowerShell 6.0 で導入されました。

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

-Force

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

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

-Hidden

Note

このパラメーターは、 FileSystem プロバイダーでのみ使用できます。

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

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

-Include

コマンドレットが子項目を取得する際に一致する 1 つ以上の文字列パターンの配列を指定します。一致するすべての項目が出力に含まれます。パス要素またはパターン ( "*.txt"など) を入力します。ワイルドカード文字を使用できます。 Include パラメーターは、コマンドに項目の内容 (ワイルドカード文字がC:\Windows ディレクトリの内容を指定するC:\Windows\*など) が含まれている場合にのみ有効です。

Note

Includeパラメーターと Exclude パラメーターは、LiteralPath パラメーターと共に使用しても無効です。これは PowerShell 7 で修正されています。

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

-LiteralPath

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

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

Note

Includeパラメーターと Exclude パラメーターは、LiteralPath パラメーターと共に使用しても無効です。これは PowerShell 7 で修正されています。

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

-Name

場所内の項目の名前のみを取得します。出力は、パイプラインを他のコマンドに送信できる文字列オブジェクトです。返される名前は、 Path パラメーターの値を基準にしています。

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

-Path

1 つ以上の場所へのパスを指定します。ワイルドカードを使用できます。既定の場所は現在のディレクトリ (.) です。

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

-ReadOnly

Note

このパラメーターは、 FileSystem プロバイダーでのみ使用できます。

読み取り専用アイテムのみを取得するには、 ReadOnly パラメーターまたは Attributes パラメーター ReadOnly プロパティを使用します。

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

-Recurse

指定された場所にある項目と、その場所のすべての子項目にある項目を取得します。

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

-SSLServerAuthentication

Note

このパラメーターは、 Certificate プロバイダーでのみ使用できます。

EnhancedKeyUsageList プロパティ値にServer Authenticationされている証明書の一覧を取得するには、SSLServerAuthentication パラメーターを使用します。

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

-System

Note

このパラメーターは、 FileSystem プロバイダーでのみ使用できます。

システムファイルとディレクトリのみを取得します。システムファイルとフォルダーのみを取得するには、 System パラメーターまたは Attributes パラメーター System プロパティを使用します。

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

-UseTransaction

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

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

入力

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」を参照してください。

次の方法で共有

Get-ChildItem

構文

説明

例

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

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

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

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

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

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

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

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

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

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

パラメーター

-Attributes

-CodeSigningCert

-Depth

-Directory

-DnsName

-DocumentEncryptionCert

-Eku

-Exclude

-ExpiringInDays

-File

-Filter

-FollowSymlink

-Force

-Hidden

-Include

-LiteralPath

-Name

-Path

-ReadOnly

-Recurse

-SSLServerAuthentication

-System

-UseTransaction

入力

出力

メモ

関連リンク

その他のリソース

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

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

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

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