Get-Item

  • 参考
模块:
Microsoft.PowerShell.Management

获取位于指定位置的项。

语法

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 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:\WindowsLastAccessTime 属性。 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*"

示例 8：获取硬链接信息

在 PowerShell 6.2 中，添加了备用视图以获取硬链接信息。 若要获取硬链接信息，请通过管道将输出传递给 Format-Table -View childrenWithHardlink

Get-Item -Path C:\PathWhichIsAHardLink | Format-Table -View childrenWithHardlink

参数

-Credential

注意

任何随 PowerShell 一起安装的提供程序都不支持此参数。 若要模拟其他用户，或在运行此 cmdlet 时提升凭据，请使用 Invoke-Command。

Type:PSCredential
Position:Named
Default value:Current user
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Exclude

指定此 cmdlet 在操作中排除的项目或项作为字符串数组。 此参数值使 Path 参数有效。 请输入路径元素或模式，例如 *.txt。 允许使用通配符。 仅当命令包含项的内容（例如C:\Windows\*，通配符指定目录的内容C:\Windows）时，Exclude 参数才有效。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Filter

指定用于限定 Path 参数的筛选器。 FileSystem 提供程序是唯一支持筛选器的已安装 PowerShell 提供程序。 筛选器比其他参数更高效。 当 cmdlet 获取对象而不是在检索对象后让 PowerShell 筛选对象时，提供程序应用筛选器。 筛选器字符串将传递给 .NET API 以枚举文件。 API 仅支持 * 通配符和 ? 通配符。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Force

指示此 cmdlet 获取无法访问的项目，例如隐藏项。 不同提供程序有不同的实现。 有关详细信息，请参阅 about_Providers。 即使使用 Force 参数，cmdlet 也无法替代安全限制。

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Include

指定此 cmdlet 将在操作中包含的一个项或多个项（作为一个字符串数组）。 此参数值使 Path 参数有效。 请输入路径元素或模式，例如 *.txt。 允许使用通配符。 仅当命令包含项的内容（例如C:\Windows\*，通配符指定目录的内容C:\Windows）时，Include 参数才有效。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-LiteralPath

指定一个或多个位置的路径。 文本路径的值与键入的完全一样使用。 不会将任何字符解释为通配符。 如果路径包括转义符，请将其括在单引号中。 单引号告知 PowerShell 不要将任何字符解释为转义序列。

有关详细信息，请参阅 about_Quoting_Rules。

Type:String[]
Aliases:PSPath, LP
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Path

指定项的路径。 此 cmdlet 获取位于指定位置的项。 允许使用通配符。 此参数是必需的，但参数名称 Path 是可选的。

使用点 (.) 指定当前位置。 使用通配符 (*) 指定当前位置中的所有项。

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Stream

从文件获取指定的备用 NTFS 文件流。 输入流名称。 支持通配符。 若要获取所有流，请使用星号 (*) 。 此参数对文件夹无效。

Stream 是 FileSystem 提供程序添加到 cmdlet 的 Get-Item 动态参数。 此参数仅在文件系统驱动器中有效。

Type:String[]
Position:Named
Default value:No alternate file streams
Required:False
Accept pipeline input:False
Accept wildcard characters:True

输入

String

可以通过管道将包含路径的字符串传递给此 cmdlet。

输出

Object

此 cmdlet 返回它获取的对象。 类型由路径中的对象的类型确定。

备注

此 cmdlet 没有 Recurse 参数，因为它仅获取一个项，而不是其内容。 若要以递归方式获取项的内容，请使用 Get-ChildItem。

若要浏览注册表，请使用此 cmdlet 获取注册表项和 Get-ItemProperty 获取注册表值和数据。 注册表值被视为注册表项的属性。

此 cmdlet 用于处理由任何提供程序公开的数据。 若要列出会话中可用的提供程序，请键入 Get-PsProvider。 有关详细信息，请参阅 about_Providers。