Sdílet prostřednictvím

Write-Debug

  • Reference
Modul:
Microsoft.PowerShell.Utility

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

Syntaxe

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.

Typ:String
Aliasy:Msg
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Vstupy

String

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

Výstupy

None

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