Set-PSDebug
Be- és kikapcsolja a szkript hibakeresési funkcióit, beállítja a nyomkövetési szintet, és bekapcsolja a szigorú módot.
Syntax
on
Set-PSDebug
[-Trace <Int32>]
[-Step]
[-Strict]
[<CommonParameters>]
off
Set-PSDebug
[-Off]
[<CommonParameters>]
Description
A Set-PSDebug parancsmag be- és kikapcsolja a szkript hibakeresési funkcióit, beállítja a nyomkövetési szintet, és bekapcsolja a szigorú módot. Alapértelmezés szerint a PowerShell hibakeresési funkciói ki vannak kapcsolva.
Ha a Trace paraméter értéke 1, a szkriptek minden sora le lesz követve a futtatás során. Ha a paraméter értéke 2, a változó-hozzárendelések, a függvényhívások és a szkripthívások is nyomon lesznek követve. Ha a lépés paraméter van megadva, a rendszer a szkript minden sora előtt kéri.
Példák
1. példa: A nyomkövetési szint beállítása
Ez a példa a nyomkövetési szintet 2értékre állítja, majd futtat egy szkriptet, amely az 1, 2 és 3 számokat jeleníti meg.
Set-PSDebug -Trace 2; foreach ($i in 1..3) {$i}
DEBUG: 1+ Set-PSDebug -Trace 2; foreach ($i in >>>> 1..3) {$i}
DEBUG: ! SET $foreach = 'IEnumerator'.
DEBUG: 1+ Set-PSDebug -Trace 2; foreach ( >>>> $i in 1..3) {$i}
DEBUG: ! SET $i = '1'.
DEBUG: 1+ Set-PSDebug -Trace 2; foreach ($i in 1..3) { >>>> $i}
1
DEBUG: 1+ Set-PSDebug -Trace 2; foreach ( >>>> $i in 1..3) {$i}
DEBUG: ! SET $i = '2'.
DEBUG: 1+ Set-PSDebug -Trace 2; foreach ($i in 1..3) { >>>> $i}
2
DEBUG: 1+ Set-PSDebug -Trace 2; foreach ( >>>> $i in 1..3) {$i}
DEBUG: ! SET $i = '3'.
DEBUG: 1+ Set-PSDebug -Trace 2; foreach ($i in 1..3) { >>>> $i}
3
DEBUG: 1+ Set-PSDebug -Trace 2; foreach ( >>>> $i in 1..3) {$i}
DEBUG: ! SET $foreach = ''.
2. példa: A lépcsőzés bekapcsolása
Ez a példa bekapcsolja a lépcsőzést, majd futtat egy szkriptet, amely megjeleníti az 1, 2 és 3 számokat.
Set-PSDebug -Step; foreach ($i in 1..3) {$i}
Continue with this operation?
1+ Set-PSDebug -Step; foreach ($i in >>>> 1..3) {$i}
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): A
DEBUG: 1+ Set-PSDebug -Step; foreach ($i in >>>> 1..3) {$i}
1
2
3
3. példa: Szigorú mód használata
Ez a példa szigorú módba helyezi a PowerShellt, és megpróbál hozzáférni egy olyan változóhoz, amely nem rendelkezik hozzárendelt értékkel.
Set-PSDebug -Strict; $NewVar
The variable '$NewVar' cannot be retrieved because it has not been set.
At line:1 char:22
+ Set-PSDebug -Strict; $NewVar
4. példa: Hibakeresési funkciók kikapcsolása
Ez a példa kikapcsolja az összes hibakeresési funkciót, majd futtat egy szkriptet, amely megjeleníti az 1, 2 és 3 számokat.
Set-PSDebug -Off; foreach ($i in 1..3) {$i}
1
2
3
Paraméterek
-Off
Kikapcsolja az összes szkript hibakeresési funkcióját.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
off
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Step
Bekapcsolja a szkriptlépést. Az egyes sorok futtatása előtt a PowerShell megkéri, hogy állítsa le, folytassa vagy adjon meg egy új értelmezőszintet a szkript állapotának vizsgálatához.
A step paraméter megadása automatikusan beállítja a 1nyomkövetési szintjét.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
on
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Strict
Azt adja meg, hogy a változókhoz értéket kell hozzárendelni, mielőtt egy szkriptben hivatkoznak rá. Ha egy változóra az érték hozzárendelése előtt hivatkozik, a PowerShell kivételhibát ad vissza. Ez egyenértékű a Set-StrictMode -Version 1. További információ: Set-StrictMode.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
on
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Trace
A szkript minden sorához megadja a nyomkövetési szintet. Az egyes sorok futás közben lesznek nyomon követve.
A paraméter elfogadható értékei a következők:
- 0: A szkriptkövetés kikapcsolása.
- 1: Szkriptsorok nyomkövetése futás közben.
- 2: Szkriptvonalak, változó-hozzárendelések, függvényhívások és szkriptek nyomon követése.
Paramétertulajdonságok
| Típus: | Int32 |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
on
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| 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
None
Ehhez a parancsmaghoz nem lehet folyamatbemenetet létrehozni.
Kimenetek
None
Ez a parancsmag nem ad vissza kimenetet.