Write-Debug
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 $DebugPreference
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 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ó: $DebugPreference
about_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
A parancsmagra hibakeresési üzenetet tartalmazó sztringet csövezhet.
Kimenetek
None
Ez a parancsmag nem ad vissza kimenetet. Csak a hibakeresési adatfolyamba ír.
Kapcsolódó hivatkozások
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: