Megosztás a következőn keresztül:

Write-Debug

Modul:
Microsoft.PowerShell.Utility Module

Hibakeresési üzenetet ír a konzolra.

Syntax

Default (Alapértelmezett) 

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 megjelenítheti őket a Hibakeresési paraméterrel vagy a $DebugPreference változóval.

Példák

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

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

Write-Debug "Cannot open file."

A $DebugPreference alapértelmezett értéke SilentlyContinue. 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 $DebugPreference változó értékének módosításának hatását mutatja be. Először megjelenítjük a $DebugPreference aktuális értékét, és megpróbálunk hibakeresési üzenetet írni. Ezután a $DebugPreference értékét Folytatásértékre módosítjuk, 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óért a $DebugPreference-vel kapcsolatban lásd a about_Preference_Variables-t.

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 $DebugPreference változó értékét a PowerShell-gazdagépre és a Hibakeresési streamre írja. Ebben a példában a Hibakeresés paramétert használjuk a $DebugPreference érték felülbírálásához.

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

Figyelje meg, hogy a $DebugPreference értéke megváltozik a Hibakeresés paraméter használatakor. 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.

Megjegyzés:

Ha a $DebugPreference értéke Inquire, a PowerShell leállítja a végrehajtást, és megkérdezi, hogy folytatódjon-e a végrehajtás.

A hibakeresési gyakori paraméterről további információt a about_CommonParameterscímű témakörben talál.

Paraméterek

-Message

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

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:Msg

Paraméterkészletek

(All)
Position:0
Kötelező:True
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

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.