Windows PowerShell command on Get-command Write-Debug

NAME
    Write-Debug
    
SYNOPSIS
    Writes a debug message to the console.
    
    
SYNTAX
    Write-Debug [-Message]  []
    
    
DESCRIPTION
    The Write-Debug cmdlet writes debug messages to the console from a script or command.
    
    By default, debug messages are not displayed in the console, but you can display them by using the Debug parameter 
    or the $DebugPreference variable.
    

PARAMETERS
    -Message 
        Specifies the debug message to send to the console.
        
        Required?                    true
        Position?                    0
        Default value                None
        Accept pipeline input?       True (ByValue)
        Accept wildcard characters?  false
        
    
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer, PipelineVariable, and OutVariable. For more information, see 
        about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216). 
    
INPUTS
    System.String
        You can pipe a string that contains a debug message to Write-Debug .
    
    
OUTPUTS
    None
        Write-Debug writes only to the debug stream. It does not return any output.
    
    
NOTES
    
    
        
    
    Example 1: Understand $DebugPreference
    
    PS C:\> Write-Debug "Cannot open file."
    
    This command writes a debug message. Because the value of $DebugPreference is SilentlyContinue, the message is not 
    displayed in the console.
    Example 2: Use the Debug parameter to override $DebugPreference
    
    PS C:\> $DebugPreference
    SilentlyContinue PS C:\> Write-Debug "Cannot open file."
    PS C:\>
    PS C:\> Write-Debug "Cannot open file." -Debug
    DEBUG: Cannot open file.
    
    This example shows how to use the Debug common parameter to override the value of the $DebugPreference variable 
    for a particular command.
    
    The first command displays the value of the $DebugPreference variable, which is SilentlyContinue, the default.
    
    The second command writes a debug message but, because of the value of $DebugPreference, the message does not 
    appear.
    
    The third command writes a debug message. It uses the Debug common parameter to override the value of 
    $DebugPreference and to display the debug messages resulting from this command.
    
    As a result, even though the value of $DebugPreference is SilentlyContinue, the debug message appears.
    
    For more information about the Debug common parameter, see about_CommonParameters.
    Example 3: Change the value of $DebugPreference
    
    PS C:\>$DebugPreference
    SilentlyContinue PS C:\> Write-Debug "Cannot open file." 
    PS C:\>
    PS C:\> $DebugPreference = "Continue"
    PS C:\> Write-Debug "Cannot open file."
    DEBUG: Cannot open file.
    
    This command shows the effect of changing the value of the $DebugPreference variable on the display of debug 
    messages.
    
    The first command displays the value of the $DebugPreference variable, which is SilentlyContinue, the default.
    
    The second command writes a debug message but, because of the value of $DebugPreference, the message does not 
    appear.
    
    The third command assigns a value of Continue to the $DebugPreference variable.
    
    The fourth command writes a debug message, which appears on the console.
    
    For more information about $DebugPreference, see about_Preference_Variables.
    
RELATED LINKS
    Online Version: http://go.microsoft.com/fwlink/?LinkId=821874
    Write-Error 
    Write-Host 
    Write-Output 
    Write-Progress 
    Write-Verbose 
    Write-Warning