Get-Content cmdlet 获取位于路径所指定位置处的项的内容，例如文件中的文本或函数的内容。 对于文件，内容一次读取一行，并返回对象集合，每个对象表示一行内容。

从 PowerShell 3.0 开始， Get-Content 还可以从项的开头或结尾获取指定的行数。

示例 1：获取文本文件的内容

此示例获取当前目录中文件的内容。 LineNumbers.txt 文件在 This is Line X 格式中有 100 行，用于几个示例中。

1..100 | ForEach-Object { Add-Content -Path .\LineNumbers.txt -Value "This is line $_." }
Get-Content -Path .\LineNumbers.txt
This is Line 1
This is Line 2
This is line 99.
This is line 100.

数组值 1-100 沿着管道向下发送到 ForEach-Object cmdlet。 ForEach-Object 使用包含 Add-Content cmdlet 的脚本块创建 LineNumbers.txt 文件。 变量 $_ 表示数组值，因为每个对象都沿管道向下发送。 Get-Content cmdlet 使用 Path 参数指定 LineNumbers.txt 文件并在 PowerShell 控制台中显示内容。

示例 2：限制 Get-Content 返回的行数

此命令获取文件的前五行。 TotalCount 参数获取前五行内容。 此示例使用示例 1 中引用的 LineNumbers.txt 。

Get-Content -Path .\LineNumbers.txt -TotalCount 5
This is Line 1
This is Line 2
This is Line 3
This is Line 4
This is Line 5

示例 3：从文本文件获取特定内容行

此命令从文件中获取特定数量的行，然后仅显示该内容的最后一行。 TotalCount 参数获取前 25 行内容。 此示例使用示例 1 中引用的 LineNumbers.txt 文件。

(Get-Content -Path .\LineNumbers.txt -TotalCount 25)[-1]
This is Line 25

Get-Content 命令包装在括号中，以便命令在转到下一步之前完成。 Get-Content 返回行数组，这样就可以在括号后面添加索引表示法来检索特定的行号。 在这种情况下， [-1] 索引指定返回的 25 个检索行数组中的最后一个索引。

示例 4：获取文本文件的最后一行

此命令从文件获取最后一行内容。 此示例使用在示例 1 中创建的 LineNumbers.txt 文件。

Get-Item -Path .\LineNumbers.txt | Get-Content -Tail 1
This is Line 100

此示例使用 Get-Item cmdlet 来演示如何通过管道将文件传递给 Get-Content 。 Tail 参数获取文件的最后一行。 此方法比检索变量中的所有行并使用 [-1] 索引表示法更快。

示例 5：获取备用数据流的内容

此示例介绍如何使用 Stream 参数为存储在 Windows NTFS 卷上的文件获取备用数据流的内容。 在此示例中， Set-Content cmdlet 用于在名为 Stream.txt 的文件中创建示例内容。

Set-Content -Path .\Stream.txt -Value 'This is the content of the Stream.txt file'
# Specify a wildcard to the Stream parameter to display all streams of the recently created file.
Get-Item -Path .\Stream.txt -Stream *
PSPath        : Microsoft.PowerShell.Core\FileSystem::C:\Test\Stream.txt::$DATA
PSParentPath  : Microsoft.PowerShell.Core\FileSystem::C:\Test
PSChildName   : Stream.txt::$DATA
PSDrive       : C
PSProvider    : Microsoft.PowerShell.Core\FileSystem
PSIsContainer : False
FileName      : C:\Test\Stream.txt
Stream        : :$DATA
Length        : 44
# Retrieve the content of the primary stream.
# Note the single quotes to prevent variable substitution.
Get-Content -Path .\Stream.txt -Stream ':$DATA'
This is the content of the Stream.txt file
# Alternative way to get the same content.
Get-Content -Path .\Stream.txt -Stream ""
# The primary stream doesn't need to be specified to get the primary stream of the file.
# This gets the same data as the prior two examples.
Get-Content -Path .\Stream.txt
This is the content of the Stream.txt file
# Use the Stream parameter of Add-Content to create a new Stream containing sample content.
$addContentSplat = @{
    Path = '.\Stream.txt'
    Stream = 'NewStream'
    Value = 'Added a stream named NewStream to Stream.txt'
Add-Content @addContentSplat
# Use Get-Item to verify the stream was created.
Get-Item -Path .\Stream.txt -Stream *
PSPath        : Microsoft.PowerShell.Core\FileSystem::C:\Test\Stream.txt::$DATA
PSParentPath  : Microsoft.PowerShell.Core\FileSystem::C:\Test
PSChildName   : Stream.txt::$DATA
PSDrive       : C
PSProvider    : Microsoft.PowerShell.Core\FileSystem
PSIsContainer : False
FileName      : C:\Test\Stream.txt
Stream        : :$DATA
Length        : 44
PSPath        : Microsoft.PowerShell.Core\FileSystem::C:\Test\Stream.txt:NewStream
PSParentPath  : Microsoft.PowerShell.Core\FileSystem::C:\Test
PSChildName   : Stream.txt:NewStream
PSDrive       : C
PSProvider    : Microsoft.PowerShell.Core\FileSystem
PSIsContainer : False
FileName      : C:\Test\Stream.txt
Stream        : NewStream
Length        : 46
# Retrieve the content of your newly created Stream.
Get-Content -Path .\Stream.txt -Stream NewStream
Added a stream named NewStream to Stream.txt

Stream 参数是 FileSystem 提供程序的动态参数。 默认情况下， Get-Content 仅从默认流或 :$DATA 流中检索数据。 Streams 可用于存储隐藏的数据，例如属性、安全设置或其他数据。 它们也可以存储在非子项的目录中。

示例 6：获取原始内容

此示例中的命令将文件的内容作为一个字符串获取，而不是作为字符串数组。 默认情况下，如果没有 Raw 动态参数，内容将作为换行分隔字符串数组返回。 此示例使用示例 1 中引用的 LineNumbers.txt 文件。

$raw = Get-Content -Path .\LineNumbers.txt -Raw
$lines = Get-Content -Path .\LineNumbers.txt
Write-Host "Raw contains $($raw.Count) lines."
Write-Host "Lines contains $($lines.Count) lines."
Raw contains 1 lines.
Lines contains 100 lines.

示例 7：将筛选器与 Get-Content 配合使用

可以指定 Get-Content cmdlet 的筛选器。 使用筛选器限定 Path 参数时，需要包含尾随星号 ( * )，以指示路径的内容。

以下命令获取 C:\Temp 目录中所有 *.log 文件的内容。

Get-Content -Path C:\Temp\* -Filter *.log

示例 8：以字节数组的形式获取文件内容

此示例演示如何以单个对象的形式获取文件内容 [byte[]] 。

$byteArray = Get-Content -Path C:\temp\test.txt -AsByteStream -Raw
Get-Member -InputObject $bytearray
TypeName: System.Byte[]
Name           MemberType            Definition
----           ----------            ----------
Count          AliasProperty         Count = Length
Add            Method                int IList.Add(System.Object value)

第一个命令使用 AsByteStream 参数从文件中获取字节流。 Raw 参数可确保将字节作为 [System.Byte[]] 返回。 如果缺少 Raw 参数，则返回值为字节流，PowerShell 将其解释为 [System.Object[]] 。

-AsByteStream

指定内容应以字节流的形式读取。 AsByteStream 参数是在 Windows PowerShell 6.0 中引入的。

将 AsByteStream 参数与 Encoding 参数一起使用时，将发出警告。 AsByteStream 参数会忽略任何编码，输出将作为字节流返回。