获取子项 (Microsoft.PowerShell.Management)

Get-ChildItem

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

句法

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
   [[-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 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 参数仅返回指定路径中的文件或目录名称。返回的名称与 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 cmdlet 使用Path 参数指定C:\Test\*.txt。 Path 使用星号 (*) 通配符指定文件扩展名为 .txt 的所有文件。 Recurse 参数搜索 Path 目录及其子目录，如 Directory: 标题中所示。 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 cmdlet 使用Path 参数指定目录C:\Test。 Path 参数包含尾随星号 (*) 通配符来指定目录的内容。 Include 参数使用星号 (*) 通配符指定文件扩展名为 .txt 的所有文件。

使用 Include 参数时，Path 参数需要尾随星号 (*) 通配符来指定目录的内容。例如，-路径 C:\Test\*。

• 如果命令中添加了 Recurse 参数，则 Path 参数中的尾随星号 (*) 是可选的。 Recurse 参数从 Path 目录及其子目录获取项目。例如，-Path C:\Test\ -Recurse -Ininclude *.txt
• 如果 Path 参数中不包含尾随星号 (*)，则该命令不会返回任何输出并返回到 PowerShell 提示符。例如，-路径 C:\Test\。

示例 5：使用 Exclude 参数获取子项

该示例的输出显示了目录 C:\Test\Logs 的内容。输出是使用排除和递归参数的其他命令的参考。

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。 排除参数使用星号 (*) 通配符指定以 A 或 a 开头的任何文件或目录被排除在输出之外。

使用排除参数时，Path参数中的尾随星号(*)是可选的。例如，-Path C:\Test\Logs 或 -Path C:\Test\Logs\*。

• 如果 Path 参数中不包含尾随星号 (*)，则显示 Path 参数的内容。例外情况是与排除参数值匹配的文件名或子目录名称。
• 如果 Path 参数中包含尾随星号 (*)，则该命令将递归到 Path 参数的子目录。例外情况是与排除参数值匹配的文件名或子目录名称。
• 如果将 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* 开头的子项。目前，排除参数仅适用于子项，不适用于项目属性。

示例7：获取具有代码签名权限的所有证书

此示例获取 PowerShell Cert: 驱动器中具有代码签名权限的每个证书。

Get-ChildItem cmdlet 使用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 cmdlet 使用Path 参数指定C:\Parent。 Depth 参数指定两个递归级别。 Get-ChildItem 显示由Path参数指定的目录和两级子目录的内容。

示例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 系统上表示的文件权限
• 用户是文件所有者
• 群组是群组所有者
• Size 是 Unix 系统上表示的文件或目录的大小

笔记

此功能在 PowerShell 7.1 中从实验性转变为主流。

示例 11：获取接合点的链接目标

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

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

笔记

此参数仅在文件系统提供程序中可用。

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

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

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

要查找具有常用属性的文件和文件夹，请使用属性参数。或者，参数目录、文件、隐藏、只读和系统。

Attributes 参数支持以下属性：

Archive
Compressed
Device
Directory
Encrypted
Hidden
IntegrityStream
Normal
NoScrubData
NotContentIndexed
Offline
ReadOnly
ReparsePoint
SparseFile
System
Temporary

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

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

• !（不是）
• +（与）
• ，（或）

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

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

• D（目录）
• H（隐藏）
• R（只读）
• S（系统）

FlagsExpression[FileAttributes]

Archive, Compressed, Device, Directory, Encrypted, Hidden, IntegrityStream, Normal, NoScrubData, NotContentIndexed, Offline, ReadOnly, ReparsePoint, SparseFile, System, Temporary

命名

None

False

False

False

-CodeSigningCert

笔记

此参数仅在证书提供者中可用。

要获取其 EnhancedKeyUsageList 属性值中具有代码签名的证书列表，请使用 CodeSigningCert 参数。

SwitchParameter

命名

None

False

False

False

-Depth

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

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

笔记

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

UInt32

命名

None

False

False

False

-Directory

笔记

此参数仅在文件系统提供程序中可用。

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

SwitchParameter

ad

命名

None

False

False

False

-DnsName

笔记

此参数仅在证书提供者中可用。

指定与 cmdlet 获取的证书的 DNSNameList 属性匹配的域名或名称模式。此参数的值可以是 Unicode 或 ASCII。 Punycode 值转换为 Unicode。允许使用通配符 (*)。

PowerShell 7.1 中重新引入了此参数

Dns名称表示

命名

None

False

False

True

-DocumentEncryptionCert

笔记

此参数仅在证书提供者中可用。

要获取其 EnhancedKeyUsageList 属性值中具有 Document Encryption 的证书列表，请使用 DocumentEncryptionCert 参数。

SwitchParameter

命名

None

False

False

False

-Eku

笔记

此参数仅在证书提供者中可用。

指定与 cmdlet 获取的证书的 EnhancedKeyUsageList 属性匹配的文本或文本模式。允许使用通配符 (*)。 EnhancedKeyUsageList 属性包含 EKU 的友好名称和 OID 字段。

此参数在 PowerShell 7.1 中重新引入

String

命名

None

False

False

True

-Exclude

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

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

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

String[]

命名

None

False

False

True

-ExpiringInDays

笔记

此参数仅在证书提供者中可用。

指定 cmdlet 应仅返回在指定天数或之前到期的证书。值零 (0) 获取已过期的证书。

此参数在 PowerShell 7.1 中重新引入

整数32

命名

None

False

False

False

-File

笔记

此参数仅在文件系统提供程序中可用。

要获取文件列表，请使用文件参数。您可以将Recurse参数与File结合使用。

SwitchParameter

af

命名

None

False

False

False

-Filter

指定一个过滤器来限定 Path 参数。文件系统提供程序是唯一安装的支持过滤器的 PowerShell 提供程序。过滤器比其他参数更有效。提供程序在 cmdlet 获取对象时应用筛选器，而不是让 PowerShell 在检索对象后筛选对象。过滤器字符串被传递到 .NET API 以枚举文件。 API 仅支持 * 和 ? 通配符。

String

1

None

False

False

True

-FollowSymlink

笔记

此参数仅在文件系统提供程序中可用。

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

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

SwitchParameter

命名

None

False

False

False

-Force

允许 cmdlet 获取用户无法访问的项目，例如隐藏文件或系统文件。 Force 参数不会覆盖安全限制。实施情况因提供商而异。有关详细信息，请参阅 about_Providers。

SwitchParameter

命名

False

False

False

False

-Hidden

笔记

此参数仅在文件系统提供程序中可用。

要仅获取隐藏项目，请使用 Hidden 参数或带有 Hidden 属性的 Attributes 参数。默认情况下，Get-ChildItem 不显示隐藏的项目。使用Force参数获取隐藏项目。

SwitchParameter

ah, h

命名

None

False

False

False

-Include

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

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

String[]

命名

None

False

False

True

-LiteralPath

指定到一个或多个位置的路径。 LiteralPath 的值完全按照其键入的方式使用。没有字符被解释为通配符。如果路径包含转义字符，请将其用单引号引起来。单引号告诉 PowerShell 不要将任何字符解释为转义序列。

有关更多信息，请参阅 about_Quoting_Rules。

String[]

PSPath, LP

命名

None

True

True

False

-Name

仅获取位置中项目的名称。输出是一个字符串对象，可以沿着管道发送到其他命令。返回的名称与 Path 参数的值相关。

SwitchParameter

命名

None

False

False

False

-Path

指定到一个或多个位置的路径。接受通配符。默认位置是当前目录 (.)。

String[]

0

当前目录

False

True

True

-ReadOnly

笔记

此参数仅在文件系统提供程序中可用。

要仅获取只读项，请使用 ReadOnly 参数或 Attributes 参数 ReadOnly 属性。

SwitchParameter

ar

命名

None

False

False

False

-Recurse

获取指定位置以及该位置的所有子项目中的项目。

SwitchParameter

s

命名

False

False

False

False

-SSLServerAuthentication

笔记

此参数仅在证书提供者中可用。

要获取其 EnhancedKeyUsageList 属性值中具有服务器身份验证 的证书列表，请使用 SSLServerAuthentication 参数。

SwitchParameter

命名

None

False

False

False

-System

笔记

此参数仅在文件系统提供程序中可用。

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

SwitchParameter

as

命名

None

False

False

False

输入

字符串

您可以通过管道传输包含此 cmdlet 路径的字符串。

输出

别名信息

访问 Alias: 驱动器时，cmdlet 会输出此类型。

X509商店位置

X509商店

X509证书2

访问 Cert: 驱动器时，cmdlet 会输出这些类型。

字典条目

访问 Env: 驱动器时，cmdlet 输出此类型。

目录信息

文件信息

访问文件系统驱动器时，cmdlet 输出这些类型。

功能信息

过滤器信息

该 cmdlet 在访问 Function: 驱动器时输出这些类型。

注册表键

访问注册表驱动器时，cmdlet 输出此类型。

PS变量

访问 Variable: 驱动器时，cmdlet 会输出此类型。

WSManConfigContainerElement

WSManConfigLeafElement

访问 WSMan: 驱动器时，cmdlet 会输出这些类型。

字符串

当您使用 Name 参数时，此 cmdlet 将返回字符串形式的对象名称。

笔记

PowerShell 包含以下 Get-ChildItem 别名：

• 所有平台：

  • 目录，gci

ls

Get-ChildItem 默认情况下不会获取隐藏项目。要获取隐藏项目，请使用Force参数。

Get-ChildItem cmdlet 旨在处理任何提供程序公开的数据。要列出会话中可用的提供程序，请输入 Get-PSProvider。有关详细信息，请参阅 about_Providers。