Share via


Get-ChildItem

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:\TestGet-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では、モード (属性)、LastWriteTime、ファイル サイズ (長さ)、および項目の名前一覧表示されます。 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 では、アスタリスク (*) wildカード を使用して、ファイル名拡張子.txtを持つすべてのファイルを指定します。 Recurse パラメーターは、ディレクトリの見出しに示すように、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 パラメーターはGet-ChildItem次で始まるD*サブキーを返さないよう指示します。 現在、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 パラメーターを使用します。 または、ディレクトリ、ファイル、非表示読み取りOnlyおよびシステムのパラメーターです。

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

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

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

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

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

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

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

  • D (ディレクトリ)
  • H (非表示)
  • R (読み取り専用)
  • S (システム)
Type:FlagsExpression<T>[FileAttributes]
Accepted values:Archive, Compressed, Device, Directory, Encrypted, Hidden, IntegrityStream, Normal, NoScrubData, NotContentIndexed, Offline, ReadOnly, ReparsePoint, SparseFile, System, Temporary
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CodeSigningCert

Note

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

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Depth

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

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

Note

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

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Directory

Note

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

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

Type:SwitchParameter
Aliases:ad, d
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DnsName

Note

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

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

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

Type:DnsNameRepresentation
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-DocumentEncryptionCert

Note

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

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Eku

Note

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

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

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Exclude

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

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

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

Note

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-ExpiringInDays

Note

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

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

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-File

Note

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

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

Type:SwitchParameter
Aliases:af
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Filter

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

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

Note

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

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

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Hidden

Note

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

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

Type:SwitchParameter
Aliases:ah, h
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Include

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

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

Note

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-LiteralPath

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

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

Note

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

Type:String[]
Aliases:PSPath
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

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

Type:String[]
Position:0
Default value:Current directory
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-ReadOnly

Note

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

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

Type:SwitchParameter
Aliases:ar
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Recurse

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

Type:SwitchParameter
Aliases:s
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SSLServerAuthentication

Note

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

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-System

Note

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

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

Type:SwitchParameter
Aliases:as
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseTransaction

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

Type:SwitchParameter
Aliases:usetx
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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」を参照してください