Write-Debug - Powershell 1.0 CmdLet

Microsoft Windows PowerShell is a command-line shell and scripting tool based on the Microsoft .NET Framework. It is designed for system administrators, engineers and developers to control and automate the administration of Windows and applications.

More than hundred command-line tools (so called "cmdlets") can be used to perform system administration tasks and Windows Management Instrumentation (WMI). These cmdlets are easy to use, with standard naming conventions and common parameters, and standard tools for piping, sorting, filtering, and formatting data and objects.

Write-Debug

Description
Write a debug message to the host display

Usage


Options
-message string
       The debug message to send to the console.
       {may be piped}

   CommonParameters:
       -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutVariable.

The action of Write-Debug is dependent on the value of $DebugPreference
If $DebugPreference = "Continue" powershell will show the debug message.
If $DebugPreference = "SilentlyContinue" powershell will not show the message.
If $DebugPreference = "Stop" powershell will show the message and then halt.
If $DebugPreference = "Inquire" powershell will prompt the user.

Example(s)
Write a debug message:

PS C:\>$DebugPreference = "Continue"
PS C:\>Write-Debug "Something went wrong."