如何在 PowerShell 中将文件转换为 Base64？

最近，在从事自动化项目时，我需要将文件编码为 Base64，这是一个将二进制数据转换为 ASCII 字符串格式的过程。我将在这里向您展示使用 PowerShell 将文件转换为 Base64 的不同方法以及示例和完整脚本。

要在 PowerShell 中将文件转换为 Base64，可以使用 [System.Convert]::ToBase64String 方法对从文件中获取的字节数组进行编码。例如， $base64String=[System.Convert]::ToBase64String((Get-Content -Path 'C:\MyFolder' -Encoding Byte)) 将为您提供文件的 Base64 编码字符串，然后您可以输出或使用该字符串根据需要。

什么是 Base64 编码？

Base64 是一种二进制到文本的编码机制，可将 ASCII 字符串格式的二进制数据转换为 radix-64 表示形式。然后可以轻松地传输该编码数据或将其存储在基于文本的系统中。当通过仅支持文本的介质传输数据时，通常会使用这种编码，例如在脚本中嵌入二进制文件或通过电子邮件发送文件。

使用 System.Convert 类将文件转换为 Base64

要在 PowerShell 中将文件转换为 Base64，您可以使用 .NET System.Convert 类。此类提供了一个 ToBase64String 方法，可用于将字节数组转换为 Base64 字符串。

下面是一个示例脚本，它将文件的内容读取到字节数组中，然后将其转换为 Base64 字符串：

$fileContent = Get-Content -Path 'C:\MyFolder\Myexe.exe -Encoding Byte
$base64String = [System.Convert]::ToBase64String($fileContent)
Set-Content -Path 'C:\MyFolder\base64.txt' -Value $base64String

在此脚本中，Get-Content 将文件作为字节数组读取，然后将其传递给 ToBase64String 以执行转换。使用 Set-Content 将生成的 Base64 字符串保存到文本文件中。

使用 Base64 编码和流将文件转换为 Base64

对于大文件，使用流会更有效，以避免将整个文件加载到内存中。以下示例演示如何使用 PowerShell 使用 .NET 流将文件转换为 Base64：

$filePath = 'C:\MyFolder\Myexe.exe'
$outputPath = 'C:\MyFolder\base64.txt'

$inFileStream = [System.IO.File]::OpenRead($filePath)
$base64Stream = [System.IO.MemoryStream]::new()
$base64Writer = [System.IO.StreamWriter]::new($base64Stream)

$buffer = New-Object byte[] 8192
while ($inFileStream.Read($buffer, 0, $buffer.Length)) {
    $base64Writer.Write([System.Convert]::ToBase64String($buffer))
}

$base64Writer.Flush()
$base64Stream.Position = 0
$base64String = [System.IO.StreamReader]::new($base64Stream).ReadToEnd()

Set-Content -Path $outputPath -Value $base64String

$inFileStream.Close()
$base64Stream.Close()

该脚本创建一个用于读取输入文件的文件流和一个用于写入 Base64 编码数据的内存流。它将文件块读取到缓冲区中，并将 Base64 编码的字符串写入内存流，然后将其写入输出文件。

您可以在下面的屏幕截图中看到我使用 VS code 执行 PowerShell 脚本后的输出。

使用 PowerShell 自定义函数

为了使该过程可重用，您可以创建一个自定义 PowerShell 函数，该函数封装将文件转换为 Base64 的逻辑。

这是完整的PowerShell功能。

function ConvertTo-Base64 {
    param (
        [Parameter(Mandatory=$true)]
        [string]$InputFile,
        [Parameter(Mandatory=$true)]
        [string]$OutputFile
    )

    $fileContent = Get-Content -Path $InputFile -Encoding Byte
    $base64String = [System.Convert]::ToBase64String($fileContent)
    Set-Content -Path $OutputFile -Value $base64String
}

# Usage
ConvertTo-Base64 -InputFile 'C:\MyFolder\file.exe' -OutputFile 'C:\MyFolder\base64.txt'

此函数 ConvertTo-Base64 采用两个参数：输入文件路径和输出文件路径。它读取输入文件的内容，将其编码为 Base64，并将其保存到输出文件。

结论

通过使用 .NET System.Convert 类，可以轻松使用 PowerShell 将文件编码为 Base64。

我还解释了如何使用 PowerShell 通过 Streams 使用 Base64 编码将文件转换为 Base64。我希望它有帮助。