Get-ChildItem 帮助信息_get-childitem : 缺少参数“literalpath”的某个参数。请指定一个类型为“sy-优快云博客

如下说明是翻译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