如何将导入的PowerShell模块输出记录到日志文件

我有一个PowerShell脚本，会导入多个模块并调用其中的Convert-WIM2VHD命令，但该模块产生的大量有用输出未被捕获，希望将这些输出写入日志文件。示例代码如下：

Write-Host "Loading modules.." -ForegroundColor Cyan

Import-Module C:\Users\Dev1\Downloads\WimConvertTest\WindowsImageTools\private\cleanupFile.ps1
Import-Module C:\Users\Dev1\Downloads\WimConvertTest\WindowsImageTools\private\Get-FullFilePath.ps1
Import-Module C:\Users\Dev1\Downloads\WimConvertTest\WindowsImageTools\private\Initialize-DiskPartition.ps1
Import-Module C:\Users\Dev1\Downloads\WimConvertTest\WindowsImageTools\private\Initialize-VHDPartition.ps1
Import-Module C:\Users\Dev1\Downloads\WimConvertTest\WindowsImageTools\private\MountVHDandRunBlock.ps1
Import-Module C:\Users\Dev1\Downloads\WimConvertTest\WindowsImageTools\private\New-TemporaryDirectory.ps1
Import-Module C:\Users\Dev1\Downloads\WimConvertTest\WindowsImageTools\private\Run-Executable.ps1
Import-Module C:\Users\Dev1\Downloads\WimConvertTest\WindowsImageTools\private\Set-DiskPartition.ps1
Import-Module C:\Users\Dev1\Downloads\WimConvertTest\WindowsImageTools\private\Set-VHDPartition.ps1
Import-Module C:\Users\Dev1\Downloads\WimConvertTest\WindowsImageTools\private\Wim2VhdClass.ps1
Import-Module C:\Users\Dev1\Downloads\WimConvertTest\WindowsImageTools\private\cleanupFile.ps1
Import-Module C:\Users\Dev1\Downloads\WimConvertTest\WindowsImageTools\Public\Convert-WIM2VHD.ps1

try
{
    Write-Host "========================== Creating VHDX ================================== "
    Convert-WIM2VHD -Path ".\os_1.vhdx" -SourcePath ".\os_1.wim" -Size 16GB -force -DiskLayout UEFI 
    # How to send output from imported module to a "_Convert-WIM2VHD.log"
    # Example: powershell -Command "Start-Process 'powershell.exe' -Wait -ArgumentList '-ExecutionPolicy Bypass -Command \"...?
}
catch
{
    Write-Host $Error[0]
    Write-Host $Error[0].Exception.GetType().FullName
}

以下是几种实用的解决方案：

方法一：使用PowerShell流重定向（推荐） #

PowerShell支持多流重定向，可一次性捕获命令产生的所有输出（包括Write-Host的信息流、普通输出流、错误流）：

仅写入日志文件 #

将Convert-WIM2VHD的调用行替换为：

Convert-WIM2VHD -Path ".\os_1.vhdx" -SourcePath ".\os_1.wim" -Size 16GB -force -DiskLayout UEFI *> "_Convert-WIM2VHD.log"

*>表示将所有输出流（成功流、错误流、信息流等）重定向到指定文件。

同时写入日志并在控制台显示 #

如果需要在控制台看到输出的同时保存到日志，使用Tee-Object：

Convert-WIM2VHD -Path ".\os_1.vhdx" -SourcePath ".\os_1.wim" -Size 16GB -force -DiskLayout UEFI *>&1 | Tee-Object -FilePath "_Convert-WIM2VHD.log"

*>&1将所有流合并到成功流，再通过Tee-Object同时输出到文件和控制台。

方法二：通过独立进程执行命令 #

如果模块的输出是直接写入控制台（无法通过管道捕获），可以用Start-Process启动独立PowerShell进程执行命令，并重定向输出：

Start-Process -FilePath "powershell.exe" `
    -ArgumentList "-ExecutionPolicy Bypass -Command `"Import-Module 'C:\Users\Dev1\Downloads\WimConvertTest\WindowsImageTools\Public\Convert-WIM2VHD.ps1'; Convert-WIM2VHD -Path '.\os_1.vhdx' -SourcePath '.\os_1.wim' -Size 16GB -force -DiskLayout UEFI 2>&1`"" `
    -Wait -NoNewWindow `
    -RedirectStandardOutput "_Convert-WIM2VHD.log"

参数说明：

• -Wait：等待命令执行完成后再继续脚本
• -NoNewWindow：在当前窗口执行，不弹出新窗口
• 2>&1：将错误流合并到标准输出，统一写入日志文件

方法三：修改模块输出逻辑（若有权限） #

如果模块内部大量使用Write-Host输出信息（Write-Host默认不进入管道），可以将模块中的Write-Host替换为Write-Output或Write-Information：

• 替换为Write-Output：输出直接进入成功流，可被管道或重定向捕获
• 替换为Write-Information：需在调用命令时加上-InformationAction Continue，才能捕获信息流：

  Convert-WIM2VHD -Path ".\os_1.vhdx" -SourcePath ".\os_1.wim" -Size 16GB -force -DiskLayout UEFI -InformationAction Continue *> "_Convert-WIM2VHD.log"
  

注意事项 #

• 建议使用绝对路径指定日志文件，避免因当前工作目录变化导致日志写入失败
• 若脚本需要管理员权限，使用Start-Process时需添加-Verb RunAs参数，但重定向路径需确保有写入权限

内容的提问来源于stack exchange，提问作者Kris