Get-Item
获取位于指定位置的项。
语法
Path （默认值）
Get-Item
[-Path] <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Credential <PSCredential>]
[-UseTransaction]
[-Stream <String[]>]
[<CommonParameters>]
LiteralPath
Get-Item
-LiteralPath <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Credential <PSCredential>]
[-UseTransaction]
[-Stream <String[]>]
[<CommonParameters>]
说明
Get-Item cmdlet 获取位于指定位置的项。
除非使用通配符（'*'）请求项目的所有内容，否则它不会获取位于该位置的项目的内容。
PowerShell 提供程序使用此 cmdlet 浏览不同类型的数据存储。
示例
示例 1：获取当前目录
此命令获取当前目录。 点 （'.'） 表示当前位置的项（而不是其内容）。
Get-Item .
Directory: C:\
Mode LastWriteTime Length Name
---- ------------- ------ ----
d---- 7/26/2006 10:01 AM ps-test
示例 2：获取当前目录中的所有项
此命令获取当前目录中的所有项。 通配符 （'*'） 表示当前项的所有内容。
Get-Item *
Directory: 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： 驱动器的当前目录。 检索的对象仅表示目录，而不是其内容。
Get-Item C:\
示例 4：获取指定驱动器中的项
此命令获取 C： 驱动器中的项。 通配符 （'*'） 表示容器中的所有项，而不仅仅是容器。
在 PowerShell 中，使用单个星号（''）来获取内容，而不是传统的“”。“。格式按字面解释，因此“.*”不会检索没有点的目录或文件名。
Get-Item C:\*
示例 5：获取指定目录中的属性
此命令获取“C：\Windows”目录的 LastAccessTime 属性。
LastAccessTime 只是文件系统目录的一个属性。
若要查看目录的所有属性，请键入 (Get-Item \<directory-name\>) | Get-Member。
(Get-Item C:\Windows).LastAccessTime
示例 6：显示注册表项的内容
此命令显示 Microsoft.PowerShell 注册表项的内容。
可以将此 cmdlet 与 PowerShell 注册表提供程序配合使用来获取注册表项和子项，但必须使用 Get-ItemProperty cmdlet 来获取注册表值和数据。
Get-Item HKLM:\Software\Microsoft\Powershell\1\Shellids\Microsoft.Powershell\
示例 7：获取目录中被排除的项
此命令获取包含点（'.'）名称的 Windows 目录中的项，但不以“w*”开头。 仅当路径包含通配符 （'*'） 以指定项的内容时，此命令才有效。
Get-Item c:\Windows\*.* -Exclude "w*"
参数
-Credential
指定有权执行此作的用户帐户。 默认值为当前用户。
键入用户名（如“User01”或“Domain01\User01”），或输入 PSCredential 对象，例如由 Get-Credential cmdlet 生成的用户名。
如果键入用户名，系统会提示输入密码。
警告
随 Windows PowerShell 一起安装的任何提供程序都不支持此参数。
参数属性
| 类型: | PSCredential |
| 默认值: | Current user |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-Exclude
指定一个或多个在操作中被此 cmdlet 排除的项目，以字符串数组的形式表示。 此参数的值定义了 Path 参数的限定条件。 输入路径元素或模式，例如“*.txt”。 允许使用通配符。
仅当命令包含项的内容（如“C：\Windows*”）时，Exclude 参数才有效，其中通配符指定“C：\Windows”目录的内容。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | True |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Filter
以提供程序的格式或语言指定筛选器。 此参数的值定义了 Path 参数的限定条件。
筛选器的语法（包括通配符的使用）取决于提供程序。 筛选器比其他参数更有效，因为提供程序在 cmdlet 获取对象时应用它们，而不是在检索对象后让 PowerShell 筛选对象。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | True |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Force
指示此 cmdlet 获取无法访问的项，例如隐藏项。 实现因服务提供商而异。 有关详细信息，请参阅 about_Providers。 即使使用 Force 参数，cmdlet 也无法替代安全限制。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Include
指定一个或多个此 cmdlet 在操作中包含的项，这些项以字符串数组形式表示。 此参数的值定义了 Path 参数的限定条件。 输入路径元素或模式，例如“*.txt”。 允许使用通配符。
仅当命令包含项的内容（如“C：\Windows*”）时，Include 参数才有效，其中通配符指定“C：\Windows”目录的内容。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | True |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-LiteralPath
指定项的路径。 与 Path 参数不同，LiteralPath 的值与键入时完全相同。 不会将任何字符解释为通配符。 如果路径包含转义字符，请将它括在单引号中。 单引号告知 PowerShell 不要将任何字符解释为转义序列。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | PSPath |
参数集
LiteralPath
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-Path
指定项的路径。 此 cmdlet 获取位于指定位置的项。 允许使用通配符。 此参数是必需的，但参数名称（“Path”）是可选的。
使用点 （'.'） 指定当前位置。 使用通配符 （'*'） 指定当前位置的所有项。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | True |
| 不显示: | False |
参数集
Path
| Position: | 0 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-Stream
从文件中获取指定的备用 NTFS 文件流。 输入流名称。 支持通配符。 若要获取所有流，请使用星号 \. 此参数对文件夹无效。
Stream 是 FileSystem 提供程序添加到 Get-Item cmdlet 中的动态参数。 此参数仅适用于文件系统驱动器。
参数属性
| 类型: | String[] |
| 默认值: | No alternate file streams |
| 支持通配符: | True |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-UseTransaction
在活动事务中包含该命令。 此参数仅在事务正在进行时有效。 有关详细信息，请参阅 about_Transactions。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | usetx |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。
输入
String
可以通过管道将包含路径的字符串传递给此 cmdlet。
输出
Object
此 cmdlet 返回它获取的对象。 该类型由路径中的对象类型确定。
备注
此 cmdlet 没有 Recurse 参数，因为它只获取一个项，而不是它的内容。
若要以递归方式获取项的内容，请使用 Get-ChildItem。
若要在注册表中导航，请使用此 cmdlet 来获取注册表项，使用 Get-ItemProperty 来获取注册表值和数据。
注册表值被视为注册表项的属性。
此 cmdlet 的设计目的是与任何供应商公开的数据进行协作。
若要列出会话中可用的提供程序，请键入 Get-PsProvider。
有关详细信息，请参阅 about_Providers。