Write-Debug

  • Referencia
Modul:
Microsoft.PowerShell.Utility

Hibakeresési üzenetet ír a konzolra.

Syntax

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

Description

A Write-Debug parancsmag hibakeresési üzeneteket ír a gazdagépre egy szkriptből vagy parancsból.

Alapértelmezés szerint a hibakeresési üzenetek nem jelennek meg a konzolon, de a Hibakeresés paraméterrel vagy a változóval megjelenítheti őket $DebugPreference .

Példák

1. példa: A $DebugPreference ismertetése

Ez a példa egy hibakeresési üzenetet ír.

Write-Debug "Cannot open file."

Az alapértelmezett érték a $DebugPreferenceSilentlyContinue. Ezért az üzenet nem jelenik meg a konzolon.

2. példa: A $DebugPreference értékének módosítása

Ez a példa a változó értékének módosításának $DebugPreference hatását mutatja be. Először megjelenítjük az aktuális értéket $DebugPreference , és megpróbálunk hibakeresési üzenetet írni. Ezután módosítjuk a Continue (Folytatás) $DebugPreferenceértéket, amely lehetővé teszi a hibakeresési üzenetek megjelenítését.

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

További információ: $DebugPreferenceabout_Preference_Variables.

3. példa: A Hibakeresés paraméter használata a $DebugPreference felülbírálásához

A Test-Debug függvény a változó értékét $DebugPreference a PowerShell-gazdagépre és a Hibakeresési streamre írja. Ebben a példában a Hibakeresés paraméter használatával felülbíráljuk az $DebugPreference értéket.

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

Figyelje meg, hogy a hibakeresési $DebugPreference paraméter használatakor a módosítások értéke változik. Ez a módosítás csak a függvény hatókörét érinti. Az értékre a függvényen kívül nincs hatással.

A gyakori hibakeresési paraméterről további információt a about_CommonParameters talál.

Paraméterek

-Message

Megadja a konzolra küldendő hibakeresési üzenetet.

Type:String
Aliases:Msg
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Bevitelek

String

A parancsmagra hibakeresési üzenetet tartalmazó sztringet csövezhet.

Kimenetek

None

Ez a parancsmag nem ad vissza kimenetet. Csak a hibakeresési adatfolyamba ír.