Write-Debug (Microsoft.PowerShell.Utility)

Write-Debug

将调试消息写入控制台。

句法

Write-Debug
     [-Message] <String>
     [<CommonParameters>]

描述

Write-Debug cmdlet 将调试消息从脚本或命令写入主机。

默认情况下，调试消息不会显示在控制台中，但您可以使用 Debug 参数或 $DebugPreference 变量显示它们。

示例

示例 1：了解 $DebugPreference

此示例写入一条调试消息。

Write-Debug "Cannot open file."

$DebugPreference 的默认值为SilentlyContinue。因此，该消息不会显示在控制台中。

示例 2：更改 $DebugPreference 的值

此示例显示更改 $DebugPreference 变量值的效果。首先，我们显示 $DebugPreference 的当前值并尝试写入调试消息。然后我们将$DebugPreference的值更改为Continue，这样就可以显示调试消息。

PS> $DebugPreference
SilentlyContinue
PS> Write-Debug "Cannot open file."
PS>
PS> $DebugPreference = "Continue"
PS> Write-Debug "Cannot open file."
DEBUG: Cannot open file.

有关 $DebugPreference 的详细信息，请参阅 about_Preference_Variables。

示例 3：使用 Debug 参数覆盖 $DebugPreference

Test-Debug 函数将 $DebugPreference 变量的值写入 PowerShell 主机和调试流。在此示例中，我们使用 Debug 参数来覆盖 $DebugPreference 值。

function Test-Debug {
    [CmdletBinding()]
    param()
    Write-Debug ('$DebugPreference is ' + $DebugPreference)
    Write-Host ('$DebugPreference is ' + $DebugPreference)
}

PS> Test-Debug
$DebugPreference is SilentlyContinue

PS> Test-Debug -Debug
DEBUG: $DebugPreference is Continue
$DebugPreference is Continue
PS> $DebugPreference
SilentlyContinue

请注意，当您使用 Debug 参数时，$DebugPreference 的值会发生变化。此更改仅影响函数的范围。该值在函数外部不受影响。

有关调试通用参数的更多信息，请参阅about_CommonParameters。

参数

-Message

指定要发送到控制台的调试消息。

String

Msg

0

None

True

True

False

输入

字符串

您可以通过管道将包含调试消息的字符串传递给此 cmdlet。

输出

无

此 cmdlet 不返回任何输出。它只写入调试流。