Get-Item 帮助信息

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