Get-Item
获取位于指定位置的项。
语法
Get-Item
[-Path] <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[-Stream <string[]>]
[<CommonParameters>]Get-Item
-LiteralPath <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[-Stream <string[]>]
[<CommonParameters>]Get-Item
[-Path] <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[-CodeSigningCert]
[-DocumentEncryptionCert]
[-SSLServerAuthentication]
[-DnsName <string>]
[-Eku <string[]>]
[-ExpiringInDays <int>]
[<CommonParameters>]Get-Item
-LiteralPath <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[-CodeSigningCert]
[-DocumentEncryptionCert]
[-SSLServerAuthentication]
[-DnsName <string>]
[-Eku <string[]>]
[-ExpiringInDays <int>]
[<CommonParameters>]Get-Item
[-Path] <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[<CommonParameters>]Get-Item
-LiteralPath <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[<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: 驱动器中的项。 通配符（*）表示容器中的所有项，而不仅仅是容器。
Get-Item C:\*在 PowerShell 中，使用单个星号（*）来获取内容，而不是传统的 *.*。 格式按字面解释，因此 *.* 不会检索没有点的目录或文件名。
示例 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：获取目录中具有排除项的项
本示例获取包含点（.）但以 w*开头的 Windows 目录中的项。仅当路径包含通配符（*）以指定项的内容时，此示例才有效。
Get-Item C:\Windows\*.* -Exclude "w*"示例 8：获取硬链接信息
在 PowerShell 6.2 中，添加了备用视图以获取硬链接信息。 若要获取硬链接信息，请通过管道将输出传递给 Format-Table -View childrenWithHardlink
Get-Item C:\Windows\System32\ntoskrnl.exe | Format-Table -view childrenWithHardLink
Directory: C:\Windows\System32
Mode LastWriteTime Length Name
---- ------------- ------ ----
la--- 5/12/2021 7:40 AM 10848576 ntoskrnl.exe
Mode 属性通过 la--- 中的 l 标识硬链接
示例 9：非 Windows作系统的输出
在 Unix 系统上的 PowerShell 7.1 中，Get-Item cmdlet 提供类似于 Unix 的输出：
PS> Get-Item /Users
Directory: /
UnixMode User Group LastWriteTime Size Name
-------- ---- ----- ------------- ---- ----
drwxr-xr-x root admin 12/20/2019 11:46 192 Users现在属于输出的一部分的新属性包括：
- UnixMode 是 Unix 系统上表示的文件权限
- 用户 是文件所有者
- 组 是组所有者
- 大小 是 Unix 系统上表示的文件或目录的大小
注意
此功能已从实验性迁移到 PowerShell 7.1 中的主流。
参数
-CodeSigningCert
这是 证书 提供程序提供的动态参数。 此参数和 证书 提供程序仅在 Windows 上可用。
若要获取 EnhancedKeyUsageList 属性值中具有 Code Signing 的证书，请使用 CodeSigningCert 参数。
有关详细信息，请参阅 about_Certificate_Provider。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Credential
注意
任何随 PowerShell 一起安装的提供程序都不支持此参数。 若要模拟其他用户，或在运行此 cmdlet 时提升凭据，请使用 Invoke-Command。
| 类型: | PSCredential |
| Position: | Named |
| 默认值: | Current user |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-DnsName
这是 证书 提供程序提供的动态参数。 此参数和 证书 提供程序仅在 Windows 上可用。
指定与 cmdlet 获取的证书 DNSNameList 属性匹配的域名或名称模式。 此参数的值可以是 Unicode 或 ASCII。 Punycode 值转换为 Unicode。 允许使用通配符（*）。
此参数在 PowerShell 7.1 中重新引入
有关详细信息，请参阅 about_Certificate_Provider。
| 类型: | DnsNameRepresentation |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | True |
-DocumentEncryptionCert
这是 证书 提供程序提供的动态参数。 此参数和 证书 提供程序仅在 Windows 上可用。
若要获取 EnhancedKeyUsageList 属性值中具有 Document Encryption 的证书，请使用 DocumentEncryptionCert 参数。
有关详细信息，请参阅 about_Certificate_Provider。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Eku
这是 证书 提供程序提供的动态参数。 此参数和 证书 提供程序仅在 Windows 上可用。
指定要与 cmdlet 获取的证书的 EnhancedKeyUsageList 属性匹配的文本或文本模式。 允许使用通配符（*）。
EnhancedKeyUsageList 属性包含 EKU 的友好名称和 OID 字段。
此参数在 PowerShell 7.1 中重新引入
有关详细信息，请参阅 about_Certificate_Provider。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | True |
-Exclude
指定此 cmdlet 在作中排除的项或项作为字符串数组。 此参数的值限定 Path 参数。 输入路径元素或模式，例如 *.txt。 允许使用通配符。 仅当命令包含项（如 C:\Windows\*）的内容（其中通配符指定 C:\Windows 目录的内容）时，Exclude 参数才有效。
| 类型: | String[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | True |
-ExpiringInDays
这是 证书 提供程序提供的动态参数。 此参数和 证书 提供程序仅在 Windows 上可用。
指定 cmdlet 应仅返回在指定天数内或之前过期的证书。 值为零（0）获取已过期的证书。
此参数在 PowerShell 7.1 中重新引入
有关详细信息，请参阅 about_Certificate_Provider。
| 类型: | Int32 |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Filter
指定用于限定 Path 参数的筛选器。
FileSystem 提供程序是唯一支持筛选器的已安装 PowerShell 提供程序。 筛选器比其他参数更高效。 提供程序在 cmdlet 获取对象时应用筛选器，而不是在检索对象后让 PowerShell 筛选对象。 筛选器字符串将传递给 .NET API 以枚举文件。 该 API 仅支持 * 和 ? 通配符。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | True |
-Force
指示此 cmdlet 获取无法访问的项，例如隐藏项。 实现因提供程序而异。 有关详细信息，请参阅 about_Providers。 即使使用 Force 参数，cmdlet 也不能替代安全限制。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Include
指定此 cmdlet 包含在作中的项（作为字符串数组）。 此参数的值限定 Path 参数。 输入路径元素或模式，例如 *.txt。 允许使用通配符。 仅当命令包含项的内容（如 C:\Windows\*）时，Include 参数才有效，其中通配符指定 C:\Windows 目录的内容。
| 类型: | String[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | True |
-LiteralPath
指定一个或多个位置的路径。 LiteralPath 的值与类型化完全相同。 不会将任何字符解释为通配符。 如果路径包含转义字符，请将它括在单引号中。 单引号告知 PowerShell 不要将任何字符解释为转义序列。
有关详细信息，请参阅 about_Quoting_Rules。
| 类型: | String[] |
| 别名: | PSPath, LP |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-Path
指定项的路径。 此 cmdlet 获取位于指定位置的项。 允许使用通配符。 此参数是必需的，但路径 参数名称是可选的。
使用点（.）指定当前位置。 使用通配符（*）指定当前位置的所有项。
| 类型: | String[] |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | True |
-SSLServerAuthentication
这是 证书 提供程序提供的动态参数。 此参数和 证书 提供程序仅在 Windows 上可用。
若要获取 EnhancedKeyUsageList 属性值中具有 Server Authentication 的证书，请使用 SSLServerAuthentication 参数。
有关详细信息，请参阅 about_Certificate_Provider。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Stream
这是 FileSystem 提供程序提供的动态参数。 此参数仅在 Windows 上可用。
从文件获取指定的备用数据流。 输入流名称。 支持通配符。 若要获取所有流，请使用星号（*）。 此参数在目录上有效，但请注意，默认情况下目录没有数据流。
此参数是在 PowerShell 3.0 中引入的。 从 PowerShell 7.2 开始，Get-Item 可以从目录和文件获取备用数据流。
有关详细信息，请参阅 about_FileSystem_Provider。
| 类型: | String[] |
| Position: | Named |
| 默认值: | No alternate file streams |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | True |
输入
可以通过管道传递包含此 cmdlet 路径的字符串。
输出
cmdlet 在访问 Alias: 驱动器时输出此类型。
cmdlet 在访问 Cert: 驱动器时输出这些类型。
cmdlet 在访问 Env: 驱动器时输出此类型。
该 cmdlet 在访问文件系统驱动器时输出这些类型。
该 cmdlet 在访问 Function: 驱动器时输出这些类型。
该 cmdlet 在访问注册表驱动器时输出此类型。
cmdlet 在访问 Variable: 驱动器时输出此类型。
该 cmdlet 在访问 WSMan: 驱动器时输出这些类型。
备注
PowerShell 包含以下 Get-Item别名：
- 所有平台：
gi
此 cmdlet 没有 Recurse 参数，因为它只获取一个项，而不是它的内容。
若要以递归方式获取项的内容，请使用 Get-ChildItem。
若要在注册表中导航，请使用此 cmdlet 获取注册表项和 Get-ItemProperty 来获取注册表值和数据。 注册表值被视为注册表项的属性。
此 cmdlet 旨在处理任何提供程序公开的数据。 若要列出会话中可用的提供程序，请键入 Get-PsProvider。 有关详细信息，请参阅 about_Providers。
