Write-Debug

Modul:: Microsoft.PowerShell.Utility Module

Zapíše do konzoly zprávu ladění.

Syntax

Default (Výchozí)

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

Description

Rutina Write-Debug zapisuje ladicí zprávy do hostitele ze skriptu nebo příkazu.

Ve výchozím nastavení se zprávy ladění v konzole nezobrazují, ale můžete je zobrazit pomocí parametru Debug nebo proměnné $DebugPreference.

Příklady

Příklad 1: Principy $DebugPreference

Tento příklad zapíše zprávu ladění.

Write-Debug "Cannot open file."

Výchozí hodnota $DebugPreference je silentlyContinue. Zpráva se proto v konzole nezobrazí.

Příklad 2: Změna hodnoty $DebugPreference

Tento příklad ukazuje účinek změny hodnoty proměnné $DebugPreference. Nejprve zobrazíme aktuální hodnotu $DebugPreference a pokusíme se napsat ladicí zprávu. Potom změníme hodnotu $DebugPreference na Pokračovat, což umožňuje zobrazit ladicí zprávy.

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

Další informace o $DebugPreferencenaleznete v tématu about_Preference_Variables.

Příklad 3: Přepsání $DebugPreference pomocí parametru Debug

Funkce Test-Debug zapíše hodnotu proměnné $DebugPreference do hostitele PowerShellu a do streamu Debug. V tomto příkladu použijeme parametr Debug k přepsání hodnoty $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

Všimněte si, že hodnota $DebugPreference se změní při použití parametru Debug. Tato změna má vliv pouze na rozsah funkce. Hodnota není ovlivněna mimo funkci.

Další informace o ladění společný parametr naleznete v tématu about_CommonParameters.

Parametry

-Message

Určuje zprávu ladění, která se má odeslat do konzoly.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Msg

Sady parametrů

(All)

Position:	0
Povinné:	True
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

String

Do této rutiny můžete převést řetězec, který obsahuje zprávu ladění.

Výstupy

None

Tento cmdlet nevrátí žádný výstup. Zapisuje se jenom do ladicího streamu.

Sdílet prostřednictvím