如何在 PowerShell 中写入标准错误？

Question

我无法弄清楚如何回显标准错误流并重定向可执行文件的错误流。

我来自 Bourne shell 和 Korn shell 背景，我会使用它；

# Write to stderr
echo "Error Message!" >&2

# Redirect stderr to file
/do/error 2>/tmp/err.msg

Answer 1

使用Write-Error写入stderr。要将 stderr 重定向到文件，请使用：

 Write-Error "oops" 2> /temp/err.msg

或

 exe_that_writes_to_stderr.exe bogus_arg 2> /temp/err.msg

请注意，PowerShell 将错误写入错误记录。如果您想避免错误记录的详细输出，您可以自己写出错误信息，如下所示：

PS> Write-Error "oops" -ev ev 2>$null
PS> $ev[0].exception
oops

-EV 是 -ErrorVariable 的缩写（别名）。任何错误都将存储在此参数的参数命名的变量中。 PowerShell 仍会向控制台报告错误，除非我们将错误重定向到 $null。

Answer 2

注意：

• 这个答案是关于当从外部世界调用 PowerShell 脚本时从外部世界的角度写入 stderr 的内容；虽然答案是从 Windows shell cmd.exe 的角度编写的，但它同样适用于 Unix shell，例如 bash 与 PowerShell Core 结合使用。

  
  

• 相比之下，在 Powershell 中，您应该使用 Write-Error，如 基思·希尔的回答。

• 遗憾的是，没有一种统一的方法可以同时在PowerShell内部和外部工作 -请参阅此我的回答供讨论。

---

添加到 @Chris Sear 的精彩答案：

虽然 $host.ui.WriteErrorLine 应该在所有主机中工作，但在通过 cmd.exe 调用时不会（默认情况下）写入 stderr ，例如来自批处理文件。
相比之下，[Console]::Error.WriteLine总是。

因此，如果您想编写一个在从 cmd.exe 调用时在输出流方面表现良好的 PowerShell 脚本，请使用以下函数 Write-StdErr< /code>，它使用 [Console]::Error.WriteLine
在常规 PS / cmd.exe 主机（控制台窗口）中，以及 $host.ui.WriteErrorLine 否则：

<#
.SYNOPSIS
Writes text to stderr when running in a regular console window,
to the host''s error stream otherwise.

.DESCRIPTION
Writing to true stderr allows you to write a well-behaved CLI
as a PS script that can be invoked from a batch file, for instance.

Note that PS by default sends ALL its streams to *stdout* when invoked from
cmd.exe.

This function acts similarly to Write-Host in that it simply calls
.ToString() on its input; to get the default output format, invoke
it via a pipeline and precede with Out-String.

#>
function Write-StdErr {
  param ([PSObject] $InputObject)
  $outFunc = if ($Host.Name -eq 'ConsoleHost') {
    [Console]::Error.WriteLine
  } else {
    $host.ui.WriteErrorLine
  }
  if ($InputObject) {
    [void] $outFunc.Invoke($InputObject.ToString())
  } else {
    [string[]] $lines = @()
    $Input | % { $lines += $_.ToString() }
    [void] $outFunc.Invoke($lines -join "`r`n")
  }
}

---

可选背景信息：如何PowerShell CLI 的输出流可以被外部调用者看到：

在内部，PowerShell 比传统输出流（stdout 和 stderr）更多，并且它们的数量随着时间的推移而增加（尝试 Write-Warning“I '会闻所未闻。" 3> $null 作为示例，并在 Get-Help about_Redirection。

与外界交互时，PowerShell 必须映射非传统输出流然而

，奇怪的是，PowerShell 默认发送其所有流（包括 Write-Host 和 $host.ui.WriteErrorLine()） 输出）到 stdout，当从 cmd.exe 调用时，即使将 PowerShell 的错误流映射到 stderr 是合乎逻辑的选择。此行为从（至少）v2 开始生效，并且从 v5.1 起仍然适用（并且由于向后兼容性的原因可能不会改变 - 请参阅 GitHub 问题 #7989）。

如果您从 cmd.exe 调用它，您可以使用以下命令验证这一点：

powershell -noprofile -command "'out'; Write-Error 'err'; Write-Warning 'warn'; Write-Verbose -Verbose 'verbose'; $DebugPreference='Continue'; write-debug 'debug'; $InformationPreference='Continue'; Write-Information 'info'; Write-Host 'host'; $host.ui.WriteErrorLine('uierr'); [Console]::Error.WriteLine('cerr')" >NUL

该命令写入所有 PowerShell 输出流（当您在 PowerShell 之前版本上运行时） v5 版本中，您将看到与 Write-Information 相关的附加错误消息，该消息是在 PowerShell v5 中引入的）并且具有 cmd.exe 重定向仅 stdout< /em> 到 NUL（即抑制 stdout 输出；>NUL）。

除了 cerr（来自 [Console]::Error.WriteLine()，直接写入 stderr）之外，您将看到没有输出 - 所有PowerShell 的流被发送到标准输出。

也许更奇怪的是，可以捕获 PowerShell 的错误流，但只能通过重定向：

如果您更改 >NUL 到上面的 2>NUL，它只是 PowerShell 的错误流 和 $host.ui.WriteErrorLine() 输出压制；当然，与任何重定向一样，您也可以将其发送到文件。
（如上所述，[Console]::Error.WriteLine()]总是输出到stderr，无论后者是否被重定向。）

举一个更有针对性的例子（再次，从 cmd.exe 运行）：

powershell -noprofile -command "'out'; Write-Error 'err'" 2>NUL

以上仅输出 out - Write-Error 的输出被抑制。

总结：

• 没有任何（cmd.exe）重定向或仅stdout重定向（< code>>... 或 1>...），PowerShell 将其所有输出流发送到stdout。< /p>

• 通过stderr重定向（2>...），PowerShell选择性将其错误流发送到stderr（无论 stdout 是否也被重定向）。

• 作为推论，以下常见习惯用法无法按预期工作：
  
  powershell ...>data-output.txt
  正如人们所期望的那样，这不会在将 stderr 输出打印到终端时仅将 stdout 发送到文件 data-output.txt ；相反，你必须使用
  
  powershell ... >data-output.txt 2>err-output.tmp;输入 err-output.tmp >&2;删除错误输出.tmp

由此可见，PowerShell 能够识别 cmd.exe 的重定向并有意调整其行为。
（这也可以从 PowerShell 在 cmd.exe 控制台 中生成彩色输出中看出，同时在输出重定向到文件时剥离颜色代码。 ）

Answer 3

您可能想要这个：

$host.ui.WriteErrorLine('I work in any PowerShell host')

您可能还会看到以下内容，但它假设您的 PowerShell 主机是控制台
窗口/设备，所以我认为它不太有用：

[Console]::Error.WriteLine('I will not work in the PowerShell ISE GUI')