Get-ChildItem
指定された1つまたは複数の場所にある項目と子項目を取得します。
構文
Get-ChildItem
[[-Path] <string[]>]
[[-Filter] <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Recurse]
[-Depth <uint>]
[-Force]
[-Name]
[<CommonParameters>] Get-ChildItem
[[-Filter] <string>]
-LiteralPath <string[]>
[-Include <string[]>]
[-Exclude <string[]>]
[-Recurse]
[-Depth <uint>]
[-Force]
[-Name]
[<CommonParameters>] 説明
Get-ChildItem コマンドレットは、指定された 1 つ以上の場所にある項目を取得します。 項目がコンテナーの場合、コンテナー内の項目 (子項目と呼ばれます) を取得します。
Recurse パラメーターを使用すると、すべての子コンテナー内の項目を取得し、Depth パラメーターを使用して再帰するレベルの数を制限できます。
Get-ChildItem には空のディレクトリは表示されません。
Get-ChildItem コマンドに Depth または Recurse パラメーターが含まれている場合、空のディレクトリは出力に含まれません。
Get-ChildItem コマンドレットは、任意のプロバイダーによって公開される項目を操作するように設計されています。 たとえば、項目には、ファイル システム ファイルまたはディレクトリ、レジストリ ハイブ、または証明書ストアを指定できます。 セッションで使用可能なプロバイダーを一覧表示するには、Get-PSProvider コマンドを使用します。 一部のパラメーターは、特定のプロバイダーでのみ使用できます。 詳細については、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 には、モード (属性)、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を指定します。
パス では、アスタリスク (*) ワイルドカードを使用して、ファイル名拡張子が .txtのすべてのファイルを指定します。
Recurse パラメーターは、「ディレクトリ: 見出し」に示すように、Path ディレクトリとそのサブディレクトリを検索します。
Force パラメーターは、hiddenfile.txt のように hのモードを持つ隠しファイルを表示します。
例 4: Include パラメーターを使用して子項目を取得する
この例では、Get-ChildItemInclude パラメーターを使用して、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 パラメーターを追加した場合、
*パラメーターの末尾のアスタリスク () は省略可能です。 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 C:\Test\Logs や -Path C:\Test\Logs\*などです。
-
*パラメーターに末尾のアスタリスク () が含まれていない場合は、Path パラメーターの内容が表示されます。 例外は、Exclude パラメーターの値と一致するファイル名またはサブディレクトリ名です。 -
*パラメーターに末尾のアスタリスク () が含まれている場合、コマンドは 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 パラメーターは、パス で指定されたディレクトリおよびそのサブディレクトリを検索します。
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: ハード リンク情報の取得
PowerShell 6.2 では、ハード リンク情報を取得するための代替ビューが追加されました。
Get-ChildItem -Path C:\PathContainingHardLink | Format-Table -View childrenWithHardLink例 10: Windows 以外のオペレーティング システムの出力
Unix システムの PowerShell 7.1 では、Get-ChildItem は Unix のような出力を提供します。
PS> Get-ChildItem /etc/r*
Directory: /etc
UnixMode User Group LastWriteTime Size Name
-------- ---- ----- ------------- ---- ----
drwxr-xr-x root wheel 9/30/2019 19:19 128 racoon
-rw-r--r-- root wheel 9/26/2019 18:20 1560 rc.common
-rw-r--r-- root wheel 7/31/2017 17:30 1560 rc.common~previous
-rw-r--r-- root wheel 9/27/2019 20:34 5264 rc.netboot
lrwxr-xr-x root wheel 11/8/2019 15:35 22 resolv.conf -> /private/var/run/resolv.conf
-rw-r--r-- root wheel 10/23/2019 17:41 0 rmtab
-rw-r--r-- root wheel 10/23/2019 17:41 1735 rpc
-rw-r--r-- root wheel 7/25/2017 18:37 1735 rpc~previous
-rw-r--r-- root wheel 10/23/2019 18:42 891 rtadvd.conf
-rw-r--r-- root wheel 8/24/2017 21:54 891 rtadvd.conf~previous出力の一部になった新しいプロパティは次のとおりです。
- UnixMode は、Unix システムで表されるファイルのアクセス許可です
- ユーザー がファイル所有者である
- グループ がグループ の所有者である
- サイズ は、Unix システムで表されるファイルまたはディレクトリのサイズです
手記
この機能は、PowerShell 7.1 で試験段階からメインストリームに移行されました。
例 11: ジャンクション ポイントのリンク ターゲットを取得する
Windows コマンド シェルの dir コマンドは、ファイルシステム ジャンクション ポイントのターゲットの場所を示します。 PowerShell では、この情報は、 によって返されるファイルシステム オブジェクトの Get-ChildItem プロパティから取得でき、既定の出力に表示されます。
PS D:\> New-Item -ItemType Junction -Name tmp -Target $Env:TEMP
PS D:\> Get-ChildItem | Select-Object Name, LinkTarget
Name LinkTarget
---- ----------
tmp C:\Users\user1\AppData\Local\Temp
PS D:\> Get-ChildItem
Directory: D:\
Mode LastWriteTime Length Name
---- ------------- ------ ----
l---- 12/16/2021 9:29 AM tmp -> C:\Users\user1\AppData\Local\Temp例 12: 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
手記
このパラメーターは、FileSystem プロバイダーでのみ使用できます。
指定した属性を持つファイルとフォルダーを取得します。 このパラメーターはすべての属性をサポートし、属性の複雑な組み合わせを指定できます。
たとえば、暗号化または圧縮されたシステム以外のファイル (ディレクトリではない) を取得するには、次のように入力します。
Get-ChildItem -Attributes !Directory+!System+Encrypted, !Directory+!System+Compressed
よく使用される属性を持つファイルとフォルダーを検索するには、Attributes パラメーターを使用します。 または、パラメーター ディレクトリ、ファイル、非表示、読み取り専用、システム。
属性 パラメーターは、次の値をサポートしています。
ArchiveCompressedDeviceDirectoryEncryptedHiddenIntegrityStreamNormalNoScrubDataNotContentIndexedOfflineReadOnlyReparsePointSparseFileSystemTemporary
これらの属性の詳細については、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
手記
このパラメーターは、Certificate プロバイダーでのみ使用できます。
Code Signing プロパティ値に されている証明書の一覧を取得するには、CodeSigningCert パラメーターを使用します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Depth
このパラメーターは PowerShell 5.0 で追加され、再帰の深さを制御できます。 既定では、Get-ChildItem は親ディレクトリの内容を表示します。
Depth パラメーターは、再帰に含まれるサブディレクトリ レベルの数を決定し、内容を表示します。
たとえば、-Depth 2 には、Path パラメーターのディレクトリ、第 1 レベルのサブディレクトリ、および第 2 レベルのサブディレクトリが含まれます。 既定では、ディレクトリ名とファイル名が出力に含まれます。
手記
PowerShell または cmd.exeの Windows コンピューターでは、tree.com コマンドを使用してディレクトリ構造のグラフィカル ビューを表示できます。
| 型: | UInt32 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Directory
手記
このパラメーターは、FileSystem プロバイダーでのみ使用できます。
ディレクトリの一覧を取得するには、Directory パラメーターまたは Attributes パラメーターと Directory プロパティを使用します。 Recurse パラメーターは、Directoryで使用できます。
| 型: | SwitchParameter |
| Aliases: | ad |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DnsName
手記
このパラメーターは、Certificate プロバイダーでのみ使用できます。
コマンドレットが取得する証明書の DNSNameList プロパティと一致するドメイン名または名前パターンを指定します。 このパラメーターの値は、Unicode または ASCIIにすることができます。 Punycode 値は Unicode に変換されます。 ワイルドカード文字 (*) を使用できます。
このパラメーターは PowerShell 7.1 で再導入されました
| 型: | DnsNameRepresentation |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | True |
-DocumentEncryptionCert
手記
このパラメーターは、Certificate プロバイダーでのみ使用できます。
Document Encryption プロパティ値に 証明書の一覧を取得するには、DocumentEncryptionCert パラメーターを使用します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Eku
手記
このパラメーターは、Certificate プロバイダーでのみ使用できます。
コマンドレットが取得する証明書の EnhancedKeyUsageList プロパティと一致するテキストまたはテキスト パターンを指定します。 ワイルドカード文字 (*) を使用できます。
EnhancedKeyUsageList プロパティには、EKU のフレンドリ名と OID フィールドが含まれます。
このパラメーターは PowerShell 7.1 で再導入されました
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | True |
-Exclude
コマンドレットが子項目を取得する際に一致する 1 つ以上の文字列パターンの配列を指定します。 一致する項目はすべて出力から除外されます。
*.txt や A*などのパス要素またはパターンを入力します。
ワイルドカード文字を使用できます。
* パラメーターの末尾のアスタリスク () は省略可能です。 たとえば、-Path C:\Test\Logs や -Path C:\Test\Logs\*などです。 末尾のアスタリスク (*) が含まれている場合、コマンドは Path パラメーターのサブディレクトリに再帰します。 アスタリスク (*) を指定しないと、Path パラメーターの内容が表示されます。 詳細については、例 5 と「メモ」セクションを参照してください。
Include パラメーターと Exclude パラメーターを一緒に使用できます。 ただし、除外は包含の後に適用され、最終的な出力に影響を与える可能性があります。
| 型: | String[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | True |
-ExpiringInDays
手記
このパラメーターは、Certificate プロバイダーでのみ使用できます。
コマンドレットは、指定した日数以前に期限切れになっている証明書のみを返すように指定します。 値 0 (0) は、有効期限が切れた証明書を取得します。
このパラメーターは PowerShell 7.1 で再導入されました
| 型: | Int32 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-File
手記
このパラメーターは、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
手記
このパラメーターは、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
手記
このパラメーターは、FileSystem プロバイダーでのみ使用できます。
非表示のアイテムのみを取得するには、Hidden パラメーターまたは Attributes パラメーターを使用して、Hidden プロパティを使用します。 既定では、Get-ChildItem には非表示のアイテムは表示されません。 非表示のアイテムを取得するには、Force パラメーターを使用します。
| 型: | SwitchParameter |
| Aliases: | ah, h |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Include
コマンドレットが子項目を取得する際に一致する 1 つ以上の文字列パターンの配列を指定します。 一致するすべての項目が出力に含まれます。 パス要素またはパターン ("*.txt"など) を入力します。
ワイルドカード文字を使用できます。
Include パラメーターは、コマンドに項目の内容 (ワイルドカード文字が C:\Windows\* ディレクトリの内容を指定する C:\Windowsなど) が含まれている場合にのみ有効です。
Include パラメーターと Exclude パラメーターを一緒に使用できます。 ただし、除外は包含の後に適用され、最終的な出力に影響を与える可能性があります。
| 型: | String[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | True |
-LiteralPath
1 つ以上の場所へのパスを指定します。 LiteralPath の値は、入力されたとおりにそのまま使用されます。 ワイルドカードとして解釈される文字はありません。 パスにエスケープ文字が含まれている場合は、単一引用符で囲みます。 単一引用符は、エスケープ シーケンスとして文字を解釈しないように PowerShell に指示します。
詳細については、about_Quoting_Rulesを参照してください。
| 型: | String[] |
| Aliases: | PSPath, LP |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Name
場所内の項目の名前のみを取得します。 出力は、パイプラインを他のコマンドに送信できる文字列オブジェクトです。 返される名前は、Path パラメーターの値を基準にしています。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Path
1 つ以上の場所へのパスを指定します。 指定しない場合、既定の場所は現在のディレクトリ (.) です。 ワイルドカードを使用できます。
Recurse パラメーターで Path パラメーターを使用する場合は注意が必要です。 詳細については、この記事の「NOTES」セクションを参照してください。
| 型: | String[] |
| 配置: | 0 |
| 規定値: | Current directory |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | True |
-ReadOnly
手記
このパラメーターは、FileSystem プロバイダーでのみ使用できます。
読み取り専用アイテムのみを取得するには、ReadOnly パラメーターまたは Attributes パラメーター ReadOnly プロパティを使用します。
| 型: | SwitchParameter |
| Aliases: | ar |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Recurse
指定した場所およびその場所内のすべての子項目から項目を取得します。
| 型: | SwitchParameter |
| Aliases: | s, r |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SSLServerAuthentication
手記
このパラメーターは、Certificate プロバイダーでのみ使用できます。
Server Authentication プロパティ値に 証明書の一覧を取得するには、SSLServerAuthentication パラメーターを使用します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-System
手記
このパラメーターは、FileSystem プロバイダーでのみ使用できます。
システム ファイルとディレクトリのみを取得します。 システム ファイルとフォルダーのみを取得するには、System パラメーターまたは Attributes パラメーター System プロパティを使用します。
| 型: | SwitchParameter |
| Aliases: | as |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
このコマンドレットへのパスを含む文字列をパイプ処理できます。
出力
コマンドレットは、Alias: ドライブにアクセスするときにこの種類を出力します。
コマンドレットは、Cert: ドライブにアクセスするときにこれらの型を出力します。
コマンドレットは、Env: ドライブにアクセスするときにこの種類を出力します。
このコマンドレットは、FileSystem ドライブにアクセスするときにこれらの種類を出力します。
コマンドレットは、Function: ドライブにアクセスするときにこれらの型を出力します。
このコマンドレットは、レジストリ ドライブにアクセスするときにこの種類を出力します。
コマンドレットは、Variable: ドライブにアクセスするときにこの種類を出力します。
コマンドレットは、WSMan: ドライブにアクセスするときにこれらの型を出力します。
Name パラメーターを使用すると、このコマンドレットはオブジェクト名を文字列として返します。
メモ
PowerShell には、Get-ChildItemの次のエイリアスが含まれています。
- すべてのプラットフォーム:
-
dir、gci
-
- ウィンドウズ：
ls
Path パラメーターを使用した再帰動作の :
Get-ChildItem -Recurse パラメーターで を使用すると、コマンドレットは、ワイルドカード パターンかリテラル名かにかかわらず、最後のパス コンポーネントを検索します。
- 最後のパス コンポーネントがターゲット ディレクトリの既存の直下サブディレクトリと一致する場合、コマンドレットは一致するディレクトリに対して再帰的な列挙を実行します。
- 最後のパス コンポーネントがターゲット ディレクトリの既存の直接サブディレクトリと一致しない場合、コマンドレットはターゲット ディレクトリの階層で、最後のパス コンポーネントと一致する項目を再帰的に検索します。
Get-ChildItem -Recurse パラメーターと Name パラメーターで を使用すると、動作が変わります。 このコマンドは、ターゲット ディレクトリの直接の子項目の最後のパス コンポーネントを検索します。
- 直接の子項目間で一致する項目がある場合、コマンドレットは一致する項目に対して再帰的な列挙を実行します。 ワイルドカード照合は、ターゲット ディレクトリの最上位レベルで 1 回だけ行われます。 結果は、LiteralPath パラメーターに個別に渡されたかのように処理されます。
- 最後のパス コンポーネントが最上位の項目と一致しない場合は、エラーが発生します。
Recurse パラメーターで Path パラメーターを使用しないでください。 最良の結果を得るには:
- LiteralPath 使用してターゲット ディレクトリを指定し、最後のパス コンポーネントの再帰的な検索をトリガーしないようにします。
- フィルター または パラメーターを使用して、ターゲット ディレクトリの階層のすべてのレベルで検索するワイルドカードまたはリテラル パターンを指定します。
関連リンク
PowerShell