Get-ChildItem cmdlet命令可以在一个或多个位置获取项目和子项目。 如果项目是容器，则它将项目放入容器内，称为子项目。 位置可以是注册表配置单元，文件系统注册表或证书存储。
此cmdlet不会显示空目录。 gci，dir，ls是此cmdlet的别名。
使用-Recurse参数获取所有子容器中的项目，并使用-Depth参数限制要递归的级别数。
语法
Get-ChildItem
[[-Path] <string[]>]
[[-Filter] <string>]
[-Recurse]
[-Depth <uint32>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Name]
[-Force] [-Directory]
[-Attributes <FlagsExpression[FileAttributes]>][-FollowSymlink]
[-File]
[-Hidden]
[-System]
[-ReadOnly]
[<CommonParameters>]
参数
-Attribute
此参数获取具有指定属性的文件和文件夹，它支持所有属性，并允许您指定属性的复杂组合。
此参数支持以下属性：
- Archive, Device, Directory, Encrypted, IntegrityStream, Hidden, NotContentIndexed, Normal, Offline, NoScrubData, ReadOnly, ReparsePoint, Compressed, System, SparseFile, and Temporary。
使用以下运算符组合属性：
! (NOT)+ (AND), (OR)
注意：请勿使用运算符及其属性之间的空格，而应在逗号后使用。
通用属性使用以下缩写：
D (Directory)H (Hidden)R (Read-only)S (System)
-Depth
-Depth参数已添加到PowerShell 5.0中，并允许控制递归的深度。默认情况下，cmdlet get-ChildItem显示父目录的内容。
此参数确定递归中包含的子目录级别的数量并显示其内容。
-Directory
-Directory参数用于获取目录列表。还可以在目录中使用-Recurse参数
-Exclude
-Exclude参数指定为字符串数组，即属性。它还指定cmdlet从操作中排除的那些项目。 -Exclude参数的值限定-Path参数。
输入模式或路径元素，例如A*或*.txt。 允许使用通配符。
-Include
-Include参数将属性指定为字符串数组。它还指定cmdlet包括在操作中的那些项目。 -Include参数的值限定Path参数。 输入模式或路径元素，例如*.txt。
仅当cmdlet包含项目的内容(例如C:\Windows\*)时，此参数才有效，其中通配符*指定C:\Windows目录的内容。
-File-File参数用于获取文件列表。还可以将-Recurse参数与-File参数一起使用。
-Filter
-Filter参数指定用于限定-Path参数的过滤器。此参数比其他参数更有效，因为提供程序在cmdlet检索对象时应用它们，而不是让PowerShell在检索对象后对其进行过滤。 过滤器的字符串传递给.NET API以枚举文件，并且该API支持?和*通配符。
-Force-Force参数用于获取用户无法访问的项目，例如系统文件或隐藏文件。 此参数不会覆盖文件/安全权限。
-Hidden
-Hidden参数或带有Hidden属性的-attribute参数仅用于获取隐藏的项目。
-Path
-Path参数用于指定一个或多个位置的路径。默认位置是当前目录.，允许使用通配符。
-LiteralPath
-LiteralPath参数还用于指定一个或多个位置的路径。 与-Path参数不同，此参数的值将按键入时的原样使用。如果路径包含任何转义字符，则将其用引号引起来。没有字符被解释为通配符。 单引号指示Windows PowerShell不要将任何字符解释为转义序列。
-Name-Name参数用于仅检索位置中项目的名称。此参数的输出是一个字符串对象，可以将其沿管道发送到其他命令。接受通配符。
-Recurse-Recurse参数用于获取指定位置中的项目以及该位置的所有子项目。
-System
将-System参数或-Attribute参数与System属性一起使用，仅获取系统文件和目录。
-ReadOnly
将-ReadOnly参数或-Attribute参数与Readonly属性一起使用，以仅获取只读项目。
-FollowSymlink
-FollowSymlink参数用于搜索以这些符号链接为目标的目录。它是一个动态参数。它仅在FileSystem提供程序中受支持。
示例
示例1： 在当前位置获取子项
在此示例中，此cmdlet(get-childItem)获取当前目录或位置中的子项。 它显示所有文件和子目录名称。 如果某项没有子项，则此cmdlet不会返回任何输出，并返回到PowerShell提示符。
默认情况下，此cmdlet列出模式，LastWriteTime，文件的大小(长度)以及项目的名称。
示例2： 获取给定路径的子项
本示例显示使用-Path参数在cmdlet中给定路径的子项。
示例3： 获取给定目录或位置中子项的名称
本示例使用-Name参数仅显示给定目录中项目或文件的名称。 此cmdlet使用-Path参数指定目录。
示例4： 获取当前目录及其子目录中的子项
本示例将cmdlet get-childItem与-Recurse参数一起使用，以搜索当前目录及其子目录。
示例5： 使用深度参数获取项目
本示例使用-Depth参数来确定递归中包含的子目录层次的数量。 那些空目录从输出中排除。
cmdlet get-chilItem使用-Path参数指定C:\users。 -Depth参数指定两个递归级别。
cmdlet get-childItem -Path C:\users -Depth 1显示由-Path参数指定的目录内容和子目录的一级。