获取位于指定位置的项。
语法
Get-Item [-LiteralPath] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-UseTransaction] [<CommonParameters>] Get-Item [-Path] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-UseTransaction] [<CommonParameters>]
说明
Get-Item cmdlet 获取位于指定位置的项。除非使用通配符 (*) 来请求该项的所有内容，否则此命令不会获取位于该位置的项的内容。
Windows PowerShell 提供程序通过使用 Get-Item cmdlet，可以在不同类型的数据存储进行导航。
参数
-Credential <PSCredential>
指定有权执行此操作的用户帐户。默认值为当前用户。
键入用户名，如“User01”或“Domain01\User01”；或输入 PSCredential 对象，如 Get-Credential cmdlet 生成的一个 PSCredential 对象。如果键入用户名，则将提示您输入密码。
随同 Windows PowerShell 一起安装的任何提供程序都不支持此参数。
|
是否为必需？ |
false |
|
位置？ |
named |
|
默认值 |
|
|
是否接受管道输入？ |
true (ByPropertyName) |
|
是否接受通配符？ |
false |
-Exclude <string[]>
忽略指定项。此参数的值对 Path 参数进行限定。请输入路径元素或模式，例如“*.txt”。允许使用通配符。
仅当该命令包括项的内容时（例如，C:\Windows\*，其中通配符指定 C:\Windows 目录的内容），Exclude 参数才有效。
|
是否为必需？ |
false |
|
位置？ |
named |
|
默认值 |
|
|
是否接受管道输入？ |
false |
|
是否接受通配符？ |
false |
-Filter <string>
以提供程序的格式或语言指定筛选器。此参数的值对 Path 参数进行限定。筛选器的语法（包括通配符的使用）取决于提供程序。筛选器比其他参数更有效，因为提供程序是在检索对象时应用筛选器，而不是在检索对象后再由 Windows PowerShell 筛选对象。
|
是否为必需？ |
false |
|
位置？ |
named |
|
默认值 |
|
|
是否接受管道输入？ |
false |
|
是否接受通配符？ |
false |
-Force
允许 cmdlet 获取非此不能访问的项，如隐藏项。不同提供程序有不同的实现。有关详细信息，请参阅 about_Providers。即使使用 Force 参数，该 cmdlet 也无法覆盖安全限制。
|
是否为必需？ |
false |
|
位置？ |
named |
|
默认值 |
|
|
是否接受管道输入？ |
false |
|
是否接受通配符？ |
false |
-Include <string[]>
只检索指定项。此参数的值对 Path 参数进行限定。请输入路径元素或模式，例如“*.txt”。允许使用通配符。
仅当该命令包括项的内容时（例如，C:\Windows\*，其中通配符指定 C:\Windows 目录的内容），Include 参数才有效。
|
是否为必需？ |
false |
|
位置？ |
named |
|
默认值 |
|
|
是否接受管道输入？ |
false |
|
是否接受通配符？ |
false |
-LiteralPath <string[]>
指定项的路径。与 Path 不同，LiteralPath 的值严格按照所键入的形式使用。不会将任何字符解释为通配符。如果路径包括转义符，请将其括在单引号中。单引号会告知 Windows PowerShell 不要将所有字符都解释为转义序列。
|
是否为必需？ |
true |
|
位置？ |
1 |
|
默认值 |
|
|
是否接受管道输入？ |
true (ByPropertyName) |
|
是否接受通配符？ |
false |
-Path <string[]>
指定项的路径。Get-Item 获取位于指定位置的项。允许使用通配符。此参数为必需参数，但参数名（“Path”）为可选项。
使用点 (.)指定当前位置。使用通配符 (*) 可以指定当前位置中的所有项。
|
是否为必需？ |
true |
|
位置？ |
1 |
|
默认值 |
|
|
是否接受管道输入？ |
true (ByValue, ByPropertyName) |
|
是否接受通配符？ |
false |
-UseTransaction
将命令包含在活动事务中。仅当正在执行事务时，此参数才有效。有关详细信息，请参阅 about_Transactions。
|
是否为必需？ |
false |
|
位置？ |
named |
|
默认值 |
|
|
是否接受管道输入？ |
false |
|
是否接受通配符？ |
false |
<CommonParameters>
此 cmdlet 支持通用参数：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息，请参阅 about_Commonparameters.
输入和输出
输入类型是指可通过管道传递给 cmdlet 的对象的类型。返回类型是指 Cmdlet 所返回对象的类型。
|
输入 |
System.String 可以通过管道将包含路径的字符串传递给 Get-Item。 |
|
输出 |
Object Get-Item 返回所获取的对象。类型由路径中的对象的类型确定。 |
说明
还可以使用 Get-Item 的内置别名“gi”来对其进行引用。有关详细信息，请参阅 about_Aliases。
Get-Item 没有 Recurse 参数，因为它只获取项，而不获取其内容。要递归获取项的内容，请使用 Get-ChildItem。
若要在注册表中导航，请使用 Get-Item 来获取注册表项，使用 Get-ItemProperty 来获取注册表值和数据。注册表值被视为注册表项的属性。
Get-Item cmdlet 用于处理由任何提供程序公开的数据。要列出会话中可用的提供程序，请键入“Get-PsProvider”。有关详细信息，请参阅 about_Providers。
示例 1
C:\PS>get-item . Directory: C:\ Mode LastWriteTime Length Name ---- ------------- ------ ---- d---- 7/26/2006 10:01 AM ps-test 说明 ----------- 此命令获取当前目录。Path 参数值中的点 (.)表示当前位置处的项（而非其内容）。
示例 2
C:\PS>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:\PS>get-item C:\ 说明 ----------- 此命令获取 C: 驱动器的当前目录。检索到的对象仅表示目录，而不表示其内容。
示例 4
C:\PS>get-item C:\* 说明 ----------- 此命令获取 C: 驱动器中的项。通配符 (*) 表示容器中的所有项，而不仅仅表示容器。 在 Windows 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 注册表项的内容。可以将 Windows PowerShell Registry 提供程序与 Get-Item 一起使用以获取注册表项和子项，但必须使用 Get-ItemProperty 来获取注册表值和数据。
示例 7
C:\PS>get-item c:\Windows\* -include *.* -exclude w* 说明 ----------- 此命令获取 Windows 目录中的其名称包含点 (.) 但不以 w* 开头的项。此命令只有在路径包括通配符 (*) 以指定项的内容的情况下才起作用。
另请参阅