Sdílet prostřednictvím

Set-PSDebug

  • Reference
Modul:
Microsoft.PowerShell.Core

Zapne a vypne funkce ladění skriptů, nastaví úroveň trasování a přepne striktní režim.

Syntaxe

Set-PSDebug
   [-Trace <Int32>]
   [-Step]
   [-Strict]
   [<CommonParameters>]
Set-PSDebug
   [-Off]
   [<CommonParameters>]

Description

Rutina Set-PSDebug zapne a vypne funkce ladění skriptů, nastaví úroveň trasování a přepne striktní režim. Ve výchozím nastavení jsou funkce ladění PowerShellu vypnuté.

Pokud má parametr Trace hodnotu 1, každý řádek skriptu je trasován při spuštění. Pokud má parametr hodnotu , přiřazení proměnných 2, volání funkcí a volání skriptu jsou také trasovány. Pokud je zadaný parametr Step, zobrazí se výzva před spuštěním každého řádku skriptu.

Příklady

Příklad 1: Nastavení úrovně trasování

Tento příklad nastaví úroveň trasování na 2a potom spustí skript, který zobrazí čísla 1, 2 a 3.

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 = ''.

Příklad 2: Zapnutí krokování

Tento příklad zapne krokování a potom spustí skript, který zobrazí čísla 1, 2 a 3.

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

Příklad 3: Použití přísného režimu

Tento příklad umístí PowerShell do striktního režimu a pokusí se získat přístup k proměnné, která nemá přiřazenou hodnotu.

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

Příklad 4: Vypnutí funkcí ladění

Tento příklad vypne všechny funkce ladění a potom spustí skript, který zobrazí čísla 1, 2 a 3.

Set-PSDebug -Off; foreach ($i in 1..3) {$i}

1
2
3

Parametry

-Off

Vypne všechny funkce ladění skriptů.

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Step

Zapne krokování skriptu. Před spuštěním každého řádku vás PowerShell vyzve, abyste zastavili, pokračovali nebo zadali novou úroveň interpretu a zkontrolovali stav skriptu.

Zadání parametru Step automaticky nastaví úroveň 1trasování .

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Strict

Určuje, že proměnné musí být přiřazeny hodnotu před odkazem ve skriptu. Pokud se na proměnnou odkazuje před přiřazením hodnoty, PowerShell vrátí chybu výjimky. To je ekvivalentní Set-StrictMode -Version 1. Další informace naleznete v tématu Set-StrictMode.

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Trace

Určuje úroveň trasování pro každý řádek ve skriptu. Každý řádek je trasován při spuštění.

Přijatelné hodnoty pro tento parametr jsou následující:

  • 0: Vypněte trasování skriptů.
  • 1: Trasování řádků skriptu při jejich spuštění.
  • 2: Trasování řádků skriptu, přiřazení proměnných, volání funkcí a skriptů.
Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

None

Do této rutiny nemůžete roušit objekty.

Výstupy

None

Tato rutina nevrátí žádný výstup.