如下说明是翻译PowerShell中: help Get-Item 产生的帮助信息.
译者
: Edengundam(
马涛
)
Get-Item
大纲
取得指定位置的项
.
语法
Get-Item [-path] <string[]> [-include <string[]>] [-exclude <string[]>] [-filter <string>] [-force] [-credential <PSCredential>] [<CommonParameters>]
Get-Item [-literalPath] <string[]> [-include <string[]>] [-exclude <string[]>] [-filter <string>] [-force] [-credential <PSCredential>] [<CommonParameters>]
详细描述
Get-Item cmdlet
取得指定位置的项
.
此命令默认不会取得指定位置项包含的内容
, ,
但是你可以使用通配符
(*)
要求返回项的所有内容
.
Windows PowerShell
提供程序使用
Get-Item cmdlet
来使您能够在不同数据存储的类型中导航
.
参数
-path <string[]>
指定项的路径
. Get-Item
返回指定位置的项
.
允许使用通配符
.
此参数是必须的
,
但是您可以省略
("-Path")
参数名
.
使用点
(.)
指定当前位置
.
使用通配符
(*)
指定当前为之下的所有项
.
强制参数
?
|
true
|
参数位置
?
|
1
|
默认值
|
<Current Location>
|
允许从管道绑定输入
?
|
true (
根据值
,
根据属性名
)
|
允许通配符扩展
?
|
true
|
-include <string[]>
只取得指定的项
.
此参数值限定参数
Path.
输入一个路径元素或者模型
,
例如
"*.txt".
允许使用通配符
.
参数
Include
只有在命令包含项的内容时才有效
,
例如
C:/Windows/*,
这里的通配符指定
C:/Windows
目录中的所有项
.
强制参数
?
|
false
|
参数位置
?
|
named
|
默认值
|
|
允许从管道绑定输入
?
|
false
|
允许通配符扩展
?
|
true
|
-exclude <string[]>
忽略指定的项
.
此参数值限定参数
Path.
输入一个路径元素或者模型
,
例如
"*.txt".
允许使用通配符
.
参数
Exclude
只有在命令包含项的内容时才有效
,
例如
C:/Windows/*,
这里的通配符指定
C:/Windows
目录中的所有项
.
强制参数
?
|
false
|
参数位置
?
|
named
|
默认值
|
|
允许从管道绑定输入
?
|
false
|
允许通配符扩展
?
|
true
|
-filter <string>
指定特定
provider
格式或语言的过滤器
.
此参数值用于限定
Path
参数
.
过滤器的语法取决于
provider
(
是否支持通配符也依赖
provider)
.
过滤器相比其他参数更加有效
,
主要因为
provider
取值时候使用过滤器
,
而不是等到
provider
将所有内容返回后
,
由
Windows PowerShell
过滤对象
.
强制参数
?
|
false
|
参数位置
?
|
named
|
默认值
|
|
允许从管道绑定输入
?
|
false
|
允许通配符扩展
?
|
false
|
-force <SwitchParameter>
在不破坏安全性的前提下
,
能够避免影响命令成功执行的限制条件
,
例如
: Force
参数能够覆盖具有只读属性的文件或创建路径中的必要成分
,
但是不会改变人和文件的权限
.
强制参数
?
|
false
|
参数位置
?
|
named
|
默认值
|
False
|
允许从管道绑定输入
?
|
false
|
允许通配符扩展
?
|
false
|
-credential <PSCredential>
使用其他凭证进行资源访问认证
. <Credential>
代表着用户名
(
例如
: "User01"
或
"Domain01/User01")
或者
PSCredential
对象
(
例如
:
通过
Get-Credential cmdlet
取得的对象
).
如果此处使用用户名
,
命令执行时会提示输入该用户密码
.
尽管此参数出现
,
但是并非所有
Windows PowerShell
核心
cmdlets
或
providers
支持此功能
.
强制参数
?
|
false
|
参数位置
?
|
named
|
默认值
|
|
允许从管道绑定输入
?
|
true (
根据属性名
)
|
允许通配符扩展
?
|
false
|
-literalPath <string[]>
指定项的路径
.
与
Path
不同
, LiteralPath
的值被直接使用
,
不会对任何通配符进行解释
.
如果路径中包含了转义字符
,
需要将路径用单引号保护
.
单引号指示
Windows PowerShell
不对字符串中的转义字符进行处理
.
强制参数
?
|
true
|
参数位置
?
|
1
|
默认值
|
|
允许从管道绑定输入
?
|
true (
根据属性名
)
|
允许通配符扩展
?
|
false
|
<
公共参数
>
此命令支持公共参数
: -Verbose, -Debug, -ErrorAction, -ErrorVariable, and -OutVariable.
更多信息
,
输入
, "get-help about_commonparameters".
输入类型
String
返回类型
Any
注意
更多信息
,
输入
"Get-Help Get-Item -detailed".
需要技术信息
,
输入
"Get-Help Get-Item -full".
Get-Item
不支持
Recurse
参数
,
这是因为此命令只取得指定的一个项
,
而不是该项的内容
.
要递归地取得一个项中的内容使用
Get-Childitem
.
要在注册表中导航
,
使用
Get-Item
取得注册项
,
使用
Get-ItemProperty
取得注册表值和数据
.
注册表值被视为注册表项的属性
.
如果需要为该命令提供多个参数
,
请使用逗号进行分隔
.
例如
, "<parameter-name> <value1>, <value2>".
你可以使用
Get-Item
的
内建别名
"gi".
需要更多信息
,
查看
About_Alias.
例
1
C:/PS>get-item .
此命令取得当前目录
.
点
(.)
表示当前位置的项
(
不是其内容
).
Directory: Microsoft.PowerShell.Core/FileSystem::C:/
Mode LastWriteTime Length Name
---- ------------- ------ ----
d---- 7/26/2006 10:01 AM ps-test
例
2
C:/PS>get-item *
此命令取得当前目录中的所有项
.
通配符
(*)
表示当前项的所有内容
.
Directory: Microsoft.PowerShell.Core/FileSystem::C:/ps-test
Mode LastWriteTime Length Name
----- ------------ ------ ----
d---- 7/26/2006 9:29 AM Logs
d---- 7/26/2006 9:26 AM Recs
-a--- 7/26/2006 9:28 AM 80 date.csv
-a--- 7/26/2006 10:01 AM 30 filenoext
-a--- 7/26/2006 9:30 AM 11472 process.doc
-a--- 7/14/2006 10:47 AM 30 test.txt
例
3
C:/PS>get-item C:/
此命令取得
C:
驱动器的当前目录
.
取得的对象只表示目录
,
而不是其中的内容
.
例
4
C:/PS>get-item C:/*
此命令取得
C:
驱动器中的项
.
通配符
(*)
表示容器中的所有项
,
而不是只容器
.
在
PowerShell
中
,
使用一个星号
(*)
取得所有内容
,
它代替了传统的
"*.*"
形式
.
在
PowerShell
中
,
模式将会按照字面意义进行解释
,
也就是说
"*.*"
将不会取得目录或文件名称中不包含的点的项
.
例
5
C:/PS>(get-item C:/Windows).LastAccessTime
此命令取得
C:/Windows
目录的
LastAccessTime
属性
. LastAccessTime
只是文件系统目录的一个属性
.
要查看一个目录上的所有属性
,
键入
"(Get-Item <directory-name>) | Get-Member".
例
6
C:/PS>get-item hklm:/software/microsoft/powershell/1/shellids/microsoft.powershell/*
此命令显示
Microsoft.PowerShell
注册表项的所有内容
.
你可以使用
Get-Item
和
Windows PowerShell
注册表提供程序取得注册表项和子项
,
但是你必须使用
Get-ItemProperty
取得注册表值和数据
.
例
7
C:/PS>get-item c:/Windows/* -include *.* -exclude w*
此命令取得
Windows
目录中名称中包含点
(.),
但是不以
w
开头的项
.
此命令只有当路径中包含通配符指定取得项的内容时才有效
.
相关链接
Clear-Item
Copy-Item
Invoke-Item
Move-Item
Set-Item
New-Item
Remove-Item
Rename-Item
about_namespace