Get-ChildItem

模块:

Microsoft.PowerShell.Management

获取一个或多个指定位置中的项和子项。

语法

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

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

说明

该 Get-ChildItem cmdlet 获取一个或多个指定位置中的项。 如果该项为容器，则此命令将获取容器内的各项（称为子项）。 可以使用 Recurse 参数获取所有子容器中的项，并使用 Depth 参数限制递归级别数。

Get-ChildItem 不显示空目录。 Get-ChildItem当命令包含 Depth 或 Recurse 参数时，输出中不包含空目录。

位置由 PowerShell 提供程序公开 Get-ChildItem 。 位置可以是文件系统目录、注册表配置单元或证书存储区。 有关详细信息，请参阅 about_Providers。

示例

示例 1：从文件系统目录获取子项

此示例从文件系统目录中获取子项。 将显示文件名和子目录名称。 对于空位置，该命令不返回任何输出并返回到 PowerShell 提示符。

cmdlet 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：获取目录中的子项名称

此示例仅列出目录中项的名称。

cmdlet Get-ChildItem 使用 Path 参数指定目录 C:\Test。 Name 参数仅返回指定路径中的文件或目录名称。

Get-ChildItem -Path C:\Test -Name

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

示例 3：获取当前目录和子目录中的子项

此示例 显示位于 当前目录及其子目录中.txt文件。

Get-ChildItem -Path C:\Test\*.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

cmdlet Get-ChildItem 使用 Path 参数来指定 C:\Test\*.txt。 路径 使用星号 (*) 通配符来指定文件扩展名 .txt为的所有文件。 Recurse 参数搜索路径目录的子目录，如“目录：”标题中所示。 Force 参数显示隐藏的文件，例如hiddenfile.txt具有 h 模式的文件。

示例 4：使用 Include 参数获取子项

在此示例中 Get-ChildItem ，Include 参数使用 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 cmdlet 使用 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

cmdlet Get-ChildItem 使用 Path 参数指定目录 C:\Test\Logs。 Exclude 参数使用星号 (*) 通配符来指定以 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。 Hive 的路径和注册表项的顶级显示在 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 证书： 驱动器中的每个证书，该驱动器具有代码签名机构。

cmdlet Get-ChildItem 使用 Path 参数指定 证书： 提供程序。 Recurse 参数搜索 Path 及其子目录指定的目录。 CodeSigningCert 参数仅获取具有代码签名机构的证书。

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

有关证书提供程序和证书：驱动器的详细信息，请参阅 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 cmdlet 使用 Path 参数指定 C：\Parent。 Depth 参数指定两个递归级别。 Get-ChildItem 显示 Path 参数指定的目录的内容和两个级别的子目录。

示例 9：获取硬链接信息

在 PowerShell 6.2 中，添加了备用视图以获取硬链接信息。

Get-ChildItem -Path C:\PathContainingHardLink | Format-Table -View childrenWithHardLink

示例 10：非 Windows 操作系统的输出

在 Unix 系统上的 Get-ChildItem PowerShell 7.1 中，提供类似于 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 - 获取连接点的链接目标

dir Windows Command Shell 中的命令显示文件系统连接点的目标位置。 在 PowerShell 中，此信息可从返回Get-ChildItem的文件系统对象的 LinkTarget 属性获取，并显示在默认输出中。

PS D:\> New-Item -ItemType Junction -Name tmp -Target $env:TEMP
PS D:\> Get-ChildItem | select 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

参数

-Attributes

获取具有指定属性的文件和文件夹。 此参数支持所有属性，并且允许你指定复杂的属性组合。

例如，若要获取加密或压缩的非系统文件（而不是目录），请键入：

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

若要查找具有常用属性的文件和文件夹，请使用 Attributes 参数。 或者，参数 目录、 文件、 隐藏、 ReadOnly 和 System。

Attributes 参数支持以下属性：

• 存档
• Compressed
• 设备
• Directory
• 已加密
• Hidden
• IntegrityStream
• 正常
• NoScrubData
• NotContentIndexed
• Offline
• ReadOnly
• ReparsePoint
• SparseFile
• 系统
• 临时

有关这些属性的说明，请参阅 FileAttributes 枚举。

若要组合属性，请使用以下运算符：

• ! (NOT)
• + (和)
• , (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

-Depth

此参数已添加到 PowerShell 5.0 中，使你能够控制递归深度。 默认情况下， Get-ChildItem 显示父目录的内容。 Depth 参数确定递归中包含的子目录级别数，并显示内容。

例如， Depth 2 包括 Path 参数的目录、第一级子目录和第二级子目录。 默认情况下，输出中包含目录名称和文件名。

注意

在 PowerShell 或 cmd.exe的 Windows 计算机上，可以使用 tree.com 命令显示目录结构的图形视图。

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

-Directory

若要获取目录列表，请使用 Directory 参数或 Attributes 参数和 Directory 属性。 可以将 Recurse 参数与 Directory 配合使用。

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

-Exclude

指定要匹配的一个或多个字符串模式的数组，因为 cmdlet 获取子项。 输出中排除了任何匹配项。 输入路径元素或模式，例如 *.txt 或 A*。 可接受通配符。

Path 参数中的尾随星号 (*) 是可选的。 例如，-Path C:\Test\Logs 或 -Path C:\Test\Logs\*。 如果包含尾随星号 (*) ，该命令将递归到 Path 参数的子目录中。 如果没有星号 (*) ，将显示 Path 参数的内容。 示例 5 和“备注”部分包括更多详细信息。

“ 包括 ”和 “排除 ”参数可以一起使用。 但是，排除项在包含之后应用，这可能会影响最终输出。

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

-File

若要获取文件列表，请使用 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 提供程序。 筛选器比其他参数更高效。 当 cmdlet 获取对象而不是在检索对象后让 PowerShell 筛选对象时，提供程序应用筛选器。 筛选器字符串将传递给 .NET API 以枚举文件。 API 仅支持 * 通配符和 ? 通配符。

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

-FollowSymlink

默认情况下， Get-ChildItem cmdlet 会显示指向递归期间发现的目录的符号链接，但不会递归到它们中。 使用 FollowSymlink 参数搜索面向这些符号链接的目录。 FollowSymlink 是一个动态参数，仅在 FileSystem 提供程序中受支持。

此参数是在 PowerShell 6.0 中引入的。

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

-Force

允许 cmdlet 获取用户无法访问的项，例如隐藏文件或系统文件。 Force 参数不会替代安全限制。 实现提供程序之间的差异。 有关详细信息，请参阅 about_Providers。

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

-Hidden

若要仅获取隐藏项，请使用 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

指定要匹配的一个或多个字符串模式的数组，因为 cmdlet 获取子项。 输出中包含任何匹配项。 请输入路径元素或模式，例如 "*.txt"。 允许使用通配符。 仅当命令包含项的内容（例如C:\Windows\*，通配符指定目录的内容C:\Windows）时，Include 参数才有效。

“ 包括 ”和 “排除 ”参数可以一起使用。 但是，排除项在包含之后应用，这可能会影响最终输出。

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

-LiteralPath

指定一个或多个位置的路径。 文本路径的值与键入的完全一样使用。 不会将任何字符解释为通配符。 如果路径包括转义符，请将其括在单引号中。 单引号告知 PowerShell 不要将任何字符解释为转义序列。

有关详细信息，请参阅 about_Quoting_Rules。

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

-Name

仅获取位置中项的名称。 输出是一个字符串对象，可将管道向下发送到其他命令。 允许使用通配符。

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

-Path

指定一个或多个位置的路径。 可以使用通配符。 默认位置是当前目录 () . 。

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

-ReadOnly

若要仅获取只读项，请使用 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

-System

仅获取系统文件和目录。 若要仅获取系统文件和文件夹，请使用 System 参数或 Attributes 参数 System 属性。

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

输入

String

可以通过管道传递包含路径的 Get-ChildItem字符串。

输出

Object

返回的对象 Get-ChildItem 的类型由提供程序驱动器路径中的对象确定。

String

如果使用 Name 参数， Get-ChildItem 则以字符串形式返回对象名称。

备注

• Get-ChildItem可以使用任何内置别名、ls和 dirgci. 有关详细信息，请参阅 about_Aliases。
• Get-ChildItem 默认情况下不会获取隐藏项。 若要获取隐藏项，请使用 Force 参数。
• 该 Get-ChildItem cmdlet 旨在处理任何提供程序公开的数据。 若要列出会话中可用的提供程序，请键入 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