PowerShell教程

PowerShell Get-childItem命令

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参数用于获取指定位置中的项目以及该位置的所有子项目。