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