如何使用 Get-Content 在 PowerShell 中读取文本文件？

您是否曾经需要在 PowerShell 中阅读文本文件？也许您正在自动化一个流程，扫描日志文件，或者只是需要一种更简单的方法来获取日志文件的内容。作为 PowerShell 用户，读取文本文件是您经常遇到的一项基本任务。 PowerShell 的 Get-Content 命令是在 PowerShell 中读取文本文件的最通用、最强大的方法之一。在本综合指南中，我们将逐步完成使用 PowerShell 读取文本文件所需的步骤。因此，让我们开始揭开使用这种强大的脚本语言读取文本文件的秘密。

PowerShell 的 Get-Content 命令简介

PowerShell 是一种命令行 shell 和脚本语言，提供各种 cmdlet 和方法来读取和操作文本文件。无论您需要处理日志文件、分析文本数据还是从配置文件中提取信息，PowerShell 都能满足您的需求。通过利用其内置 cmdlet 和脚本编写功能的强大功能，您可以轻松高效地读取和解析文本文件。 Get-Content 命令是 PowerShell 中的一个 cmdlet，使您能够读取文件的内容并将其存储在变量中或在控制台中显示。

了解在 PowerShell 中读取文本文件的基础知识

在我们深入了解 Get-Content 命令的细节之前，有必要了解在 PowerShell 中读取文本文件的基础知识。 PowerShell 支持各种文件格式，包括文本文件、XML 文件、CSV 文件和 JSON 文件。要在 PowerShell 中读取文本文件，您需要指定文件的路径。您可以使用文件的绝对路径或相对路径。绝对路径指定从驱动器根目录开始的文件的完整路径，而相对路径指定文件相对于当前位置的路径。

使用 Get-Content 命令读取文本文件

Get-Content 命令是在 PowerShell 中读取文本文件的最常见方法。要在 PowerShell 脚本中使用 Get-Content 命令，请指定文件的路径并将输出分配给变量或将其显示在 PowerShell 控制台中。

Get-Content -Path "C:\Logs\AppLog.txt"

该命令从路径参数中读取 C:\Logs 目录中单个文件“AppLog.txt”的内容，并将每一行作为字符串对象返回。

同样，您可以使用 *（星号）字符和参数 -filter 从多个文件中获取内容，如下所示：

Get-Content -path "C:\Logs\*" -Filter *.log

您还可以将输出分配给变量，如下所示。

使用 Get-Content 命令将文本文件读入变量

Get-Content 命令不仅在控制台中显示文件的内容，还允许您将内容存储在变量中。将内容存储在变量中允许您操纵数据并对其执行各种操作。

$content = Get-Content -path C:\Logs\log.txt

使用 -Raw 参数将文件的全部内容获取为单个字符串，而不是字符串数组。

使用 Get-Content 在 PowerShell 中逐行读取文本文件

有时，您可能需要在 PowerShell 中逐行读取文本文件。当您处理大文件并且一次只需要处理一行时，这会很有用。 PowerShell 提供 Get-Content cmdlet，它允许您检索文件的内容并单独处理每一行。

此命令一次读取 log.txt 文件一行，并在控制台中显示每一行。您还可以将输出分配给变量，如下所示。让我们逐行遍历文本文件的内容：

$FilePath = "C:\Logs\AppLog.Log"
$FileContents = Get-Content -Path $FilePath

$i = 1
# Read the file line by line
ForEach ($Line in $FileContents) {
    # Process each line here
    Write-Host "Line# $i :" $Line
    $i++
}

同样，您可以使用 StreamReader 类一次读取文件一行。这是使用 StreamReader 的示例：

$Reader = New-Object System.IO.StreamReader("C:\Logs\LogFile.log")

while($Line = $Reader.ReadLine()) {
    # do something with each line
    Write-host $Line
}

$Reader.Close()

此代码创建 StreamReader 类的一个新实例，并使用 while 循环读取每一行，直到没有更多的行为止。完成读取后，请确保关闭 StreamReader 对象。

搜索和过滤文件内容

除了实时监控日志文件之外，PowerShell 还允许您根据特定条件过滤日志条目。这可以通过将 Get-Content cmdlet 与其他 cmdlet（例如 Where-Object 或 Select-String）相结合来实现。这是一个例子：

$FilePath = "C:\Logs\log.txt"
$keyword = "ERROR"
Get-Content -Path $FilePath | Where-Object { $_ -like "*$keyword*" }

在此示例中，我们获取日志文件的内容和 Where-Object cmdlet，以根据特定关键字（在本例中为“ERROR”）过滤文件条目。您还可以使用正则表达式来搜索和过滤特定模式。

$LogFile = "C:\Logs\Log.txt"
$Pattern = "ERROR|WARNING"  # RegEx pattern to filter log messages

# Filter log file contents based on the pattern
$FilteredLines = Get-Content -Path $LogFile | Select-String -Pattern $pattern

# Display the filtered lines
$FilteredLines.Line

获取文本文件的第一行或最后“N”行

将 -TotalCount 参数与 Get-Content cmdlet 结合使用可从文本文件中读取第一个特定行数。例如，以下命令读取 Log.txt 文件的前两行：

Get-Content -Path "C:\Logs\Log.txt" -TotalCount 2

您还可以使用 Select-Object cmdlet 读取前“N”行。例如。

Get-Content -Path "C:\Logs\log.txt" | Select-object -First 5

使用参数 -Tail 从文本文件中获取最后“N”行。例如。

Get-Content C:\Logs\log.txt -Tail 5

该命令读取最后一行内容。您还可以通过管道将 Get-content 传输到 Select-Object cmdlet 以读取文件的最后一行。例如。，

Get-Content -Path "C:\Logs\log.txt" | Select-object -last 5

读取文本文件的特定行

有时，您可能只需要从文本文件中读取特定行，例如提取标题信息或从特定行号检索数据。 PowerShell 提供了多种方法来实现此目的。要从文本文件中读取特定行号，您可以使用带有 -Index 参数的 Select-Object cmdlet。这是一个例子：

$FilePath = "C:\Logs\Log.txt"
$LineNumber = 2
Get-Content -Path $FilePath | Select-Object -Index ($LineNumber-1)

在上面的代码中，我们指定了文本文件的路径和所需的行号。然后，带有 -Index 参数的 Select-Object cmdlet 选择指定索引号处的行并将其输出。

跳过页眉和页脚行

处理文本文件时，经常会遇到带有需要跳过的页眉或页脚行的文件。 PowerShell 允许您使用带有 -Skip 参数的 Select-Object cmdlet 跳过这些行。这是一个例子：

$FilePath = "C:\Logs\Log.txt"
$HeaderLines = 2
$FooterLines = 1

#Get contents of the file and skip certain lines
Get-Content -Path $FilePath | Select-Object -Skip $headerLines | Select-Object -SkipLast $footerLines

在此示例中，我们指定文本文件的路径以及要跳过的页眉和页脚行数。带有 -Skip 参数的 Select-Object cmdlet 会从文件开头跳过指定的行数，而 -SkipLast 参数会跳过从文件末尾算起的指定行数。

在 PowerShell 中使用 Streamreader 读取文件内容

System.IO.StreamReader 类是在 PowerShell 中读取文件内容的强大方法。 StreamReader类可以读取任何大小的文件，并且可以用于读取任何格式的文件。但是，使用 StreamReader 类比使用 Get-Content 命令需要更多的代码。

$stream = New-Object System.IO.StreamReader("C:\Logs\log.txt")
$content = $stream.ReadToEnd()
$stream.Close()

此代码创建一个新的 StreamReader 对象并读取 log.txt 文件的内容。然后，内容将存储在 $content 变量中，并且 StreamReader 对象将被关闭。与流读取器类似，您还可以使用 [System.IO.File] 类中的 ReadAllText 方法。这是一个例子：

$FileContent = [System.IO.File]::ReadAllText("C:\Logs\log.txt")

在本例中，我们使用 ReadAllText 方法读取位于“C:\Logs\log.txt”的文件的全部内容。然后，内容存储在 $FileContent 变量中，可用于进一步处理或显示。

在 PowerShell 中读取大文本文件

处理大型文本文件时，由于内存限制，将整个文件一次读入内存可能不可行。 PowerShell 提供了以更优化的方式有效读取大型文本文件的技术。

使用 -ReadCount 参数

Get-Content cmdlet 的 -ReadCount 参数允许您一次读取指定数量的行，从而减少处理大型文本文件时的内存占用。通过为 -ReadCount 指定较大的值，您可以在每次迭代中读取多行，从而提高整体性能。这是一个例子：

$FilePath = "C:\Logs\Log.txt"
$i = 1
$ReadCount = 50

Get-Content -Path $FilePath -ReadCount $readCount | ForEach-Object {
    Write-host "Iteration":$i
    # Process each block of lines here
    $_  # Output the block of lines
    $i++
}

在此示例代码中，我们使用 -ReadCount 参数指定文本文件的路径以及一次读取的行数。 Get-Content cmdlet 将以行块的形式读取文件，并且每个块都会在 ForEach-Object 循环中进行处理。

使用 StreamReader 逐块读取数据块

有效读取大型文本文件的另一种方法是使用 .NET Framework 中的 StreamReader 类分块读取文件。这是一个例子：

$FilePath = "C:\Logs\logFile.txt"
$bufferSize = 4096 #Bytes

$StreamReader = [System.IO.StreamReader]::new($FilePath)
$Buffer = New-Object char[] $bufferSize
$ReadChars = $streamReader.Read($buffer, 0, $bufferSize)

while ($readChars -ne 0) {
    # Process the chunk of data here
    $chunk = [string]::new($buffer, 0, $readChars)
    Write-Host -f Green "Processed chunk with $readChars characters"
    $chunk
    
    # Read the next chunk of data
    $readChars = $streamReader.Read($buffer, 0, $bufferSize)
}

$streamReader.Close()

在此示例中，我们创建 StreamReader 类的新实例，指定文本文件的路径和缓冲区大小（以字节为单位）。 while 循环继续逐行读取文件，直到到达流末尾。然后可以在循环内处理每一行或每一块。

在 PowerShell 中读取 CSV、JSON 和 XML 文件

以下是在 PowerShell 中使用 Get-Content 方法从 CSV、JSON 和 XML 文件读取内容的一些示例：

从 CSV 文件获取内容

如果您使用 CSV 格式的结构化数据，PowerShell 会提供 ConvertFrom-Csv cmdlet 与 Get-Content 组合来读取 CSV 文件。该cmdlet会自动检测分隔符并为每行创建对象，以便于访问和处理数据。这是一个例子：

$Data = Get-Content -Path "C:\path\to\file.csv" | ConvertFrom-csv

在此示例中，我们指定 CSV 文件的路径并使用 Get-Content cmdlet 读取该文件。生成的数据作为对象集合存储在 $data 变量中，每个对象代表 CSV 文件中的一行。您还可以使用本机方法 Import-CSV 在 PowerShell 中读取 CSV 文件！

读取 JSON 文件

要在 PowerShell 中读取 JSON 文件，可以使用 Get-Content cmdlet 读取文件内容，然后使用 ConvertFrom-Json cmdlet 将 JSON 数据转换为 PowerShell 对象。这是一个例子：

$Data = Get-Content -path "C:\Temp\data.json" -Raw | ConvertFrom-Json

#Display a specific property from the JSON data
Write-Host "Name: $($Data.Name)"

读取 XML 文件：

要在 PowerShell 中读取 XML 文件，可以使用 Get-Content cmdlet 读取文件内容，然后使用类型加速器将其转换为 XML 对象。

$Data = [xml](Get-Content -path "C:\Temp\data.xml" -Raw)

#Get a specific node value from the xml
Write-Host $Data.SelectSingleNode("//note//from").InnerText

在 PowerShell 中使用 Get-Content cmdlet 时的常见错误

使用 Get-Content 命令时，您可能会遇到一些常见错误。以下是一些最常见的错误以及修复方法：

• 找不到指定的文件：

当文件路径不正确时会出现此错误。仔细检查路径并确保该文件存在于指定位置。

• 该文件正在被另一个进程使用：

在另一个程序中打开该文件时会出现此错误。关闭程序并重试。

• 文件太大：

当文件太大而无法读入内存时，就会出现此错误。使用-ReadCount参数逐行读取文件。

在 PowerShell 中使用 Get-Content 命令的最佳实践

以下是在 PowerShell 中使用 Get-Content 命令的一些最佳实践：

• 始终使用绝对或相对路径指定文件的路径。
• 优化内存使用 - 处理大文件时使用 -ReadCount 参数。读取大型文本文件会消耗大量内存。
• 将内容存储在变量中以操纵数据并对其执行各种操作。
• 错误处理和日志记录 - 读取文本文件时，实现正确的错误处理和日志记录机制至关重要。 PowerShell 提供了各种错误处理技术，例如 try-catch 块和错误操作首选项。
• 处理 CSV、JSON 和 XML 文件时，请使用 ConvertFrom-* cmdlet。

结论

在处理数据和自动化时，在 PowerShell 中读取文本文件是一项常见任务。通过使用 Get-Content、StreamReader 或 ReadAllText 等方法，您可以轻松访问文本文件的内容并对其执行各种操作。无论您需要单独处理每一行还是将整个内容作为单个字符串读取，PowerShell 都提供了有效完成这些任务所需的方法。通过遵循本文中的分步指南，您将能够在使用 Get-Content 命令时有效地读取文本文件并避免常见错误。

通过本文提供的示例，您现在应该很好地了解如何在 PowerShell 中读取文本文件，并可以将这些知识应用到您自己的脚本和自动化工作流程中！

经常问的问题：

如何在 PowerShell 中比较文件内容？

要在 PowerShell 中比较文件内容，可以使用 Get-Content cmdlet 检索每个文件的内容，然后使用 Compare-Object cmdlet 比较内容。这是一个例子：

#Read content of file1 and file2
$content1 = Get-Content -Path "C:\Logs\Log1.txt"
$content2 = Get-Content -Path "C:\Logs\Log2.txt"
#Compare the file contents
Compare-Object -ReferenceObject $content1 -DifferenceObject $content2

如何在 PowerShell 中循环遍历文件的每一行？

要在 PowerShell 中循环访问文件的每一行，可以使用 Get-Content cmdlet 读取文件，然后使用 foreach 循环迭代每一行。这是一个例子：

$i=1
Get-Content -Path "C:\Logs\log.txt" | ForEach-Object {
  Write-Host "Line# $i :" $_
  $i++
}

如何在 PowerShell 中以字符串形式获取文件内容？

要在 PowerShell 中以字符串形式获取文件内容，可以使用 Get-Content cmdlet 并指定文件路径。这是一个例子：

$Content = Get-Content -Path "C:\Logs\log.txt"

如何在 PowerShell 中循环访问文件夹中的文件？

要在 PowerShell 中循环访问文件夹中的文件，可以使用 Get-ChildItem cmdlet 检索文件夹中的文件列表，然后使用 foreach 循环循环访问每个文件。这是一个例子：

#Get all files in the folder
$Files = Get-ChildItem -Path "C:\Temp" -File
#Loop through each file
ForEach ($File in $Files) {
 Write-Host "File: $($File.Name)"
}

使用 Get-ChildItem cmdlet 中的 -Recurse 开关以递归方式从给定文件夹的所有文件夹和子文件夹中检索文件。

如何在PowerShell中查找文件内容中的字符串？

要使用 PowerShell 在文件中查找特定字符串，可以使用 Select-String cmdlet。以下是如何执行此操作的示例：

#Parameters
$FilePath = "C:\Logs\log.txt"
$SearchString = "error"
#Get File contents and search for a word
$Results = Get-Content -Path $FilePath | Select-String -Pattern $SearchString
if ($Results) {
  Write-Host -f Green "String '$searchString' found in the file '$FilePath'"
  foreach ($Line in $Results) {
  Write-Host "Line#: $($Line.LineNumber) - $($Line.Line)"
  }
}