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 do hostitele ladicí zprávy ze skriptu nebo příkazu.

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

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 $DebugPreference proměnné. Nejprve zobrazíme aktuální hodnotu $DebugPreference zprávy ladění a pokusíme se ji napsat. Potom změníme hodnotu $DebugPreference na Continue (Pokračovat), která umožňuje zobrazení zpráv ladění.

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 najdete v $DebugPreferencetématu about_Preference_Variables.

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

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

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 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 $DebugPreference Inquire( Inquire), PowerShell zastaví provádění a zeptá se, jestli má pokračovat spuštění.

Další informace o společném parametru Ladění najdete 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.