Sdílet prostřednictvím

Set-PSDebug

Modul:
Microsoft.PowerShell.Core Module

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

Syntax

on 

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

off 

Set-PSDebug
    [-Off]
    [<CommonParameters>]

Description

Cmdlet Set-PSDebug zapíná a vypíná funkce ladění skriptů, nastavuje úroveň trasování a přepíná striktní režim. Ve výchozím nastavení jsou funkce ladění PowerShellu vypnuté.

Pokud má parametr Trace hodnotu 1, každý řádek skriptu se při spuštění trasuje. Pokud má parametr hodnotu 2, přiřazení proměnných, volání funkcí a volání skriptu jsou také trasovány. Pokud je zadaný parametr kroku, 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: Zapněte krokování

Tento příklad zapne režim 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: Vypnout funkce 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ů.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

off
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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ím parametru Krok se automaticky nastaví úroveň sledování 1.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

on
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Strict

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

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

on
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Trace

Určuje úroveň trasování pro každý řádek ve skriptu. Každý řádek je sledová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 během jejich spuštění.
  • 2: Trasování řádků skriptu, přiřazení proměnných, volání funkcí a skriptů.

Vlastnosti parametru

Typ:Int32
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

on
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

None

Do tohoto cmdletu nemůžete předávat objekty.

Výstupy

None

Tento cmdlet nevrátí žádný výstup.