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 zprávy ladění do konzoly 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 Inquire

Confirm
Continue with this operation?
[Y] Yes  [A] Yes to All  [H] Halt Command  [?] Help (default is "Y"):
$DebugPreference is Inquire
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.

Poznámka

Pokud je hodnota $DebugPreferenceInquire, PowerShell zastaví provádění a zeptá se, jestli má pokračovat provádění.

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

Řetězec, který obsahuje ladicí zprávu, můžete poslat do kanálu Write-Debug.

Výstupy

None

Write-Debug pouze zápisy do ladicího streamu. Nevrací žádný výstup.