Get-ChildItem 帮助信息

如下说明是翻译 PowerShell 中 : help Get-ChildItem 产生的帮助信息 .

译者 : Edengundam( 马涛 )

 

Get-ChildItem

 

大纲

取得一个或多个指定位置中的项和子项 .

 

语法

Get-ChildItem [[-path] <string[]>] [[-filter] <string>] [-include <string[]>] [-exclude <string[]>] [-name] [-recurse] [-force] [<CommonParameters>]

 

Get-ChildItem [-literalPath] <string[]> [[-filter] <string>] [-include <string[]>] [-exclude <string[]>] [-name] [-recurse] [-force] [<CommonParameters>]

 

详细描述

Get-Childitem cmdlet 取得一个或多个指定位置中的项和子项 . 如果该项为容器 , 命令取得容器中的项 ( 称为子项 ). 你可以使用参数 Recurse 取得子容器中的所有项 . 位置可以是文件系统位置 , 例如 : 目录 , 或者是其他提供程序公开的位置 , 例如 : 注册表配置单元或证书存储区 .

 

参数

 

-path <string[]>

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

 

强制参数 ?	false
参数位置 ?	1
默认值	< 注意 : 如果不指定 , 使用当前位置 >
允许从管道绑定输入 ?	true ( 根据值 , 根据属性名 )
允许通配符扩展 ?	true

 

-include <string[]>

只检索指定项 . 此参数值限定参数 Path. 输入一个路径元素或者模式 , 例如 "*.txt". 允许使用通配符 .

 

只有在命令包含参数 Recurse 或者路径执行目录中的内容 ( 例如 : such as C:/Windows/*, 这里的通配制定了 Windows 目录 C:/ 中的内容 ) 时才有效 .

 

强制参数 ?	false
参数位置 ?	named
默认值
允许从管道绑定输入 ?	false
允许通配符扩展 ?	true

 

-exclude <string[]>

忽略指定项 . 此参数值限定参数 Path. 输入一个路径元素或者模型 , 例如 "*.txt". 允许使用通配符 .

 

对于此命令来说 , 此参数可能无法正常工作 .

 

强制参数 ?	false
参数位置 ?	named
默认值
允许从管道绑定输入 ?	false
允许通配符扩展 ?	true

 

-filter <string>

指定特定 provider 格式或语言的过滤器 . 此参数值用于限定 Path 参数 . 过滤器的语法取决于 provider ( 是否支持通配符也依赖 provider) . 过滤器相比其他参数更加有效 , 主要因为 provider 取值时候使用过滤器 , 而不是等到 provider 将所有内容返回后 , 由 Windows PowerShell 过滤对象 .

 

强制参数 ?	false
参数位置 ?	2
默认值
允许从管道绑定输入 ?	false
允许通配符扩展 ?	true

 

-name <SwitchParameter>

只取得位置上项的名称 . 如果你通过管道将此命令输出发送给另一个命令 , 只有项的名称会被发送 .

 

强制参数 ?	false
参数位置 ?	named
默认值	False
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

-recurse <SwitchParameter>

在指定位置及其所有子项子项中检索 .

 

只有在路径指向容器 , 并且其中具有子项时 ( 例如 : C:/Windows 或 C:/Windows/*, 并且路径不能指向没有子项的项 , 例如 : C:/Windows/*.exe), 才发生递归 .

 

强制参数 ?	false
参数位置 ?	named
默认值	False
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

-force <SwitchParameter>

在不破坏安全性的前提下 , 能够避免影响命令成功执行的限制条件 , 例如 : Force 参数能够覆盖具有只读属性的文件或创建路径中的必要成分 , 但是不会改变人和文件的权限 .

 

强制参数 ?	false
参数位置 ?	named
默认值	False
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

-codeSigningCert <SwitchParameter>

仅检索具有代码签名颁发机构的证书 . 此参数只有在使用 Windows PowerShell 证书提供程序时才有效 . 更多的信息 , 键入 "get-help about_provider" 和 "get-help about_signing".

 

强制参数 ?	false
参数位置 ?	named
默认值
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

-literalPath <string[]>

指定一个或多个位置的路径 . 与 Path 不同 , LiteralPath 的值被直接使用 , 不会对任何通配符进行解释 . 如果路径中包含了转义字符 , 需要将路径用单引号保护 . 单引号指示 Windows PowerShell 不对字符串中的转义字符进行处理 .

 

强制参数 ?	true
参数位置 ?	1
默认值
允许从管道绑定输入 ?	true ( 根据属性名 )
允许通配符扩展 ?	false

 

< 公共参数 >

此命令支持公共参数 : -Verbose, -Debug, -ErrorAction, -ErrorVariable, and -OutVariable. 更多信息 , 输入 , "get-help about_commonparameters".

 

输入类型

String

 

注意

 

更多信息 , 输入 "Get-Help Get-ChildItem -detailed". 需要技术信息 , 输入 "Get-Help Get-ChildItem -full".

 

Get-Childitem 默认不取得隐藏项 . 取得隐藏项 , 使用 -Force.

 

如果需要为该命令提供多个参数 , 请使用逗号进行分隔 . 例如 , "<parameter-name> <value1>, <value2>".

 

你可以使用 Get-ChildItem 的 内建别名 "ls", "dir", and "gci". 需要更多信息 , 查看 About_Alias .

 

例 1

 

C:/PS>get-childitem

 

此命令检索当前位置的子项 . 如果当前位置是文件系统目录 , 此命令检索当前目录中的文件和子目录 . 如果项中不包含子项 , 此命令不显示任何信息 , 直接返回命令提示符 .

 

默认显示列出了模式 ( 属性 ), 最后写入时间 , 文件大小 ( 长度 ) 和文件名称 . 模式的合法值为 : d ( 目录 ), a ( 存档 ), r ( 只读 ), h ( 隐藏 ) 和 s ( 系统 ).

 

例 2

 

C:/PS>get-childitem . -Include *.txt -Recurse

 

此命令在当前目录及其子目录中检索所有的 .txt 文件 . 点 (".") 表示当前目录 , 参数 Include 指定了文件扩展名 . 参数 Recurse 指示 Windows PowerShell 递归地检索对象 , 指出命令的目标是指定目录及其内容 .

 

例 3

 

C:/PS>get-childitem c:/windows/logs/* -include *.txt -exclude A*

 

此命令列出 Logs 子目录中除了文件名以 A 开头的所有 .txt 文件 . 它适用了通配符 (*) 指示 Logs 子目录中的内容 , 而不是目录容器 . 由于命令没有包含参数 Recurse, Get-Childitem 不会自动将目录内容包含进来 ; 如果需要 , 需要显示指定它 .

 

例 4

 

C:/PS>get-childitem registry::hklm/software

 

此命令检索本地计算机注册表中 HKEY_LOCAL_MACHINE/SOFTWARE 项的所有注册表项 .

 

例 5

 

C:/PS>get-childitem -name

 

此命令只检索当前目录中项的名称 .

 

例 6

 

C:/PS>get-childitem cert:/. -recurse -codesigningcert

 

此命令获取证书存储区中具有代码签名颁发机构的所有证书 . 此命令使用了 Get-Childitem cmdlet. 路径指定为 Windows PowerShell 证书提供程序公开的 Cert: 驱动器 . 反斜线 (/) 符号指定了证书存储区的一个子目录 , 点 (.) 表示当前目录 ( 也就是证书存储区的根目录 ). 参数 Recurse 指出递归查询 , 参数 CodeSigningCertificate 指出只获取具有代码签名颁发机构的所有证书 .

 

例 7

 

C:/PS>get-childitem * -Include *.exe

 

此命令取得当前目录中所有文件扩展名为 ".exe" 的项 . 通配符 (*) 表示当前目录 ( 而不是容器 ) 的内容 . 当使用了 Include 参数而不指定 Recurse 参数时 , 路径必须指向内容 , 而不是容器 .

 

相关链接

Get-Item

Get-Alias

Get-Location

Get-Process

about_namespace