获取位于指定位置的项的内容。

语法

Get-Content [-LiteralPath] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-ReadCount <Int64>] [-TotalCount <Int64>] [-UseTransaction] [<CommonParameters>]

Get-Content [-Path] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-ReadCount <Int64>] [-TotalCount <Int64>] [-UseTransaction] [<CommonParameters>]

说明

Get-Content cmdlet 获取位于路径所指定位置的项的内容,例如,文件中的文本。此命令每次读取一行内容,并为每行返回一个对象。

参数

-Credential <PSCredential>

指定有权执行此操作的用户帐户。默认值为当前用户。

键入用户名,如“User01”或“Domain01\User01”;或输入 PSCredential 对象,如 Get-Credential cmdlet 生成的一个 PSCredential 对象。如果键入用户名,则将提示您输入密码。

随同 Windows PowerShell 一起安装的任何提供程序都不支持此参数。

是否为必需?

false

位置?

named

默认值

是否接受管道输入?

true (ByPropertyName)

是否接受通配符?

false

-Exclude <string[]>

忽略指定项。此参数的值对 Path 参数进行限定。请输入路径元素或模式,例如“*.txt”。允许使用通配符。

是否为必需?

false

位置?

named

默认值

是否接受管道输入?

false

是否接受通配符?

false

-Filter <string>

以提供程序的格式或语言指定筛选器。此参数的值对 Path 参数进行限定。筛选器的语法(包括通配符的使用)取决于提供程序。筛选器比其他参数更有效,因为提供程序是在检索对象时应用筛选器,而不是在检索对象后再由 Windows PowerShell 筛选对象。

是否为必需?

false

位置?

named

默认值

是否接受管道输入?

false

是否接受通配符?

false

-Force

覆盖阻止命令成功执行的限制,但应确保所做更改不会危及安全性。例如,Force 将覆盖只读属性或创建目录来完成文件路径,但它不会尝试更改文件权限。

是否为必需?

false

位置?

named

默认值

是否接受管道输入?

false

是否接受通配符?

false

-Include <string[]>

只检索指定项。此参数的值对 Path 参数进行限定。请输入路径元素或模式,例如“*.txt”。允许使用通配符。

是否为必需?

false

位置?

named

默认值

是否接受管道输入?

false

是否接受通配符?

false

-LiteralPath <string[]>

指定项的路径。与 Path 不同,LiteralPath 的值严格按照所键入的形式使用。不会将任何字符解释为通配符。如果路径包括转义符,请将其括在单引号中。单引号会告知 Windows PowerShell 不要将所有字符都解释为转义序列。

是否为必需?

true

位置?

1

默认值

是否接受管道输入?

true (ByPropertyName)

是否接受通配符?

false

-Path <string[]>

指定项的路径。Get-Content 将检索该项的内容。允许使用通配符。参数名(“Path”或“FilePath”)为可选项。

是否为必需?

true

位置?

1

默认值

是否接受管道输入?

true (ByPropertyName)

是否接受通配符?

false

-ReadCount <Int64>

指定每次通过管道发送的内容行数。默认值为 1。值 0(零)将一次发送所有内容。

此参数不会更改显示的内容,但会影响显示内容所用的时间。随着 ReadCount 的值增加,返回第一行所用的时间将会增加,但该操作的总计时间将会减少。这一点在非常大的项中可产生显而易见的差异。

是否为必需?

false

位置?

named

默认值

是否接受管道输入?

true (ByPropertyName)

是否接受通配符?

false

-TotalCount <Int64>

指定要检索的内容行数。默认值为 -1(所有行)。

是否为必需?

false

位置?

named

默认值

是否接受管道输入?

true (ByPropertyName)

是否接受通配符?

false

-UseTransaction

将命令包含在活动事务中。仅当正在执行事务时,此参数才有效。有关详细信息,请参阅 about_Transactions。

是否为必需?

false

位置?

named

默认值

是否接受管道输入?

false

是否接受通配符?

false

<CommonParameters>

此 cmdlet 支持通用参数:-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息,请参阅 about_Commonparameters.

输入和输出

输入类型是指可通过管道传递给 cmdlet 的对象的类型。返回类型是指 Cmdlet 所返回对象的类型。

输入

None

不能通过管道将输入传递给 Get-Content。

输出

Object

Get-Content 返回表示所获取内容的对象。对象类型取决于内容类型。

说明

还可以使用 Get-Content 的内置别名“cat”、“type”和“gc”来对其进行引用。有关详细信息,请参阅 about_Aliases。

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

示例 1

C:\PS>get-content -Path C:\Chapters\chapter1.txt

说明
-----------
此命令在控制台上显示 Chapter1.txt 文件的内容。它使用 Path 参数来指定项的名称。Get-Content 实际上将内容传入管道,但因为没有其他管道元素,所以将设置内容的格式并在控制台上显示内容。






示例 2

C:\PS>get-content c:\Logs\Log060912.txt -totalcount 50 | set-content sample.txt

说明
-----------
此命令获取 Log060912.txt 文件的前 50 行,并将它们存储在 sample.txt 文件中。此命令使用 Get-Content cmdlet 来获取文件中的文本。(省略了可选的 Path 参数名)TotalCount 参数将检索限定于前 50 行。管道运算符 (|) 将结果发送给 Set-Content,Set-Content 会将该结果放在 sample.txt 文件中。






示例 3

C:\PS>(get-content cmdlets.txt -totalcount 5)[-1]

说明
-----------
此命令获取 Cmdlets.txt 文本文件的第五行。它使用 TotalCount 参数来获取前 5 行,然后使用数组表示法来获取结果集的最后 1 行(由“-1”指示)。






另请参阅




目录