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