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 提示符。

Get-ChildItem该 cmdlet 使用 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该 cmdlet 使用 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

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

示例 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该 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

Get-ChildItem该 cmdlet 使用 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 证书： 具有代码签名机构的驱动器中的每个证书。

该 Get-ChildItem cmdlet 使用 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

参数

-Attributes

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

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

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

若要查找具有常用属性的文件和文件夹，请使用 Attributes 参数。 或者，参数 Directory、 File、 Hidden、 ReadOnly 和 System。

Attributes 参数支持以下属性：

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

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

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

• !) 非 (
• + (和)
• , (或)

请勿在运算符及其属性之间使用空格。 逗号后接受空格。

对于常见属性，请使用以下缩写：

• D (Directory)
• 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 从操作中排除的属性或属性作为字符串数组。 此参数值使 Path 参数有效。 输入路径元素或模式，例如 *.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 参数与 文件配合使用。

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 将在操作中包含的一个项或多个项（作为一个字符串数组）。 此参数值使 Path 参数有效。 请输入路径元素或模式，例如 "*.txt"。 允许使用通配符。 仅当命令包含项的内容（例如C:\Windows\*，通配符指定目录的内容C:\Windows）时，Include 参数才有效。

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

-LiteralPath

指定一个或多个位置的路径。 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以及 dir） gci运行。 有关详细信息，请参阅 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