Set-PSBreakpoint

Syntaxe

Set-PSBreakpoint
   [-Action <ScriptBlock>]
   [[-Column] <Int32>]
   [-Line] <Int32[]>
   [-Script] <String[]>
   [-Runspace <Runspace>]
   [<CommonParameters>]

Set-PSBreakpoint
   [-Action <ScriptBlock>]
   -Command <String[]>
   [[-Script] <String[]>]
   [-Runspace <Runspace>]
   [<CommonParameters>]

Set-PSBreakpoint
   [-Action <ScriptBlock>]
   [[-Script] <String[]>]
   -Variable <String[]>
   [-Mode <VariableAccessMode>]
   [-Runspace <Runspace>]
   [<CommonParameters>]

Description

Rutina Set-PSBreakpoint nastaví zarážku ve skriptu nebo v libovolném příkazu spuštěného v aktuální relaci. Zarážku můžete použít Set-PSBreakpoint k nastavení zarážky před spuštěním skriptu nebo spuštěním příkazu nebo při ladění, když se zastaví na jiné zarážce.

Set-PSBreakpoint Aplikace nemůže nastavit zarážku ve vzdáleném počítači. Pokud chcete ladit skript na vzdáleném počítači, zkopírujte skript do místního počítače a potom ho místně ladit.

Každý Set-PSBreakpoint příkaz vytvoří jeden z následujících tří typů zarážek:

• Zarážka řádku – nastaví zarážky na konkrétní souřadnici řádku a sloupce.
• Zarážka příkazů – nastaví zarážky u příkazů a funkcí.
• Zarážka proměnné – nastaví zarážky na proměnných.

Zarážku můžete nastavit na více řádcích, příkazech nebo proměnných v jednom Set-PSBreakpoint příkazu, ale každý Set-PSBreakpoint příkaz nastaví jenom jeden typ zarážky.

PowerShell na zarážce dočasně zastaví provádění a dává řízení ladicímu programu. Příkazový řádek se změní na DBG\>a zpřístupní se sada příkazů ladicího programu pro použití. Pomocí parametru Akce však můžete zadat alternativní odpověď, například podmínky pro zarážku nebo pokyny k provádění dalších úloh, jako je protokolování nebo diagnostika.

Tato rutina Set-PSBreakpoint je jednou z několika rutin navržených pro ladění skriptů PowerShellu. Další informace o ladicím programu PowerShellu najdete v tématu about_Debuggers.

Příklady

Příklad 1: Nastavení zarážky na řádku

Tento příklad nastaví zarážku na řádku 5 ve skriptu Sample.ps1. Při spuštění skriptu se provádění zastaví bezprostředně před spuštěním řádku 5.

Set-PSBreakpoint -Script "sample.ps1" -Line 5

Column     : 0
Line       : 5
Action     :
Enabled    : True
HitCount   : 0
Id         : 0
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

Když nastavíte novou zarážku podle čísla řádku, Set-PSBreakpoint rutina vygeneruje objekt zarážky řádku (System.Management.Automation.LineBreakpoint), který obsahuje ID zarážky a počet přístupů.

Příklad 2: Nastavení zarážky u funkce

Tento příklad vytvoří pro funkci v rutině Sample.ps1 zarážku Increment příkazu. Skript se zastaví bezprostředně před každým voláním zadané funkce.

Set-PSBreakpoint -Command "Increment" -Script "sample.ps1"

Command    : Increment
Action     :
Enabled    : True
HitCount   : 0
Id         : 1
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

Výsledkem je objekt zarážky příkazu. Před spuštěním skriptu je hodnota vlastnosti HitCount 0.

Příklad 3: Nastavení zarážky pro proměnnou

Tento příklad nastaví zarážku na proměnné serveru ve skriptu Sample.ps1. Používá parametr Mode s hodnotou ReadWrite k zastavení provádění, když je hodnota proměnné přečtena a těsně před změnou hodnoty.

Set-PSBreakpoint -Script "sample.ps1" -Variable "Server" -Mode ReadWrite

Příklad 4: Nastavení zarážky u každého příkazu, který začíná zadaným textem

Tento příklad nastaví zarážku pro každý příkaz ve skriptu Sample.ps1, který začíná na "write", například Write-Host.

Set-PSBreakpoint -Script Sample.ps1 -Command "write*"

Příklad 5: Nastavení zarážky v závislosti na hodnotě proměnné

Tento příklad zastaví provádění DiskTest funkce ve Test.ps1 skriptu pouze v případě, že hodnota $Disk proměnné je větší než 2.

Set-PSBreakpoint -Script "test.ps1" -Command "DiskTest" -Action { if ($Disk -gt 2) { break } }

Hodnota akce je blok skriptu, který testuje hodnotu $Disk proměnné ve funkci.

Akce pomocí klíčového break slova zastaví provádění, pokud je splněna podmínka. Alternativou (a výchozí) je Pokračovat.

Příklad 6: Nastavení zarážky u funkce

Tento příklad nastaví zarážku funkce CheckLog . Protože příkaz nezadá skript, zarážka je nastavena na cokoli, co běží v aktuální relaci. Ladicí program se přeruší při zavolání funkce, nikoli při deklaraci.

PS> Set-PSBreakpoint -Command "checklog"
Id       : 0
Command  : checklog
Enabled  : True
HitCount : 0
Action   :

function CheckLog {
>> get-eventlog -log Application |
>> where {($_.source -like "TestApp") -and ($_.Message -like "*failed*")}
>>}
>>
PS> Checklog
DEBUG: Hit breakpoint(s)
DEBUG:  Function breakpoint on 'prompt:Checklog'

Příklad 7: Nastavení zarážek na více řádcích

Tento příklad nastaví tři zarážky řádků ve skriptu Sample.ps1. Nastaví jednu zarážku ve sloupci 2 na každém řádku zadaném ve skriptu. Akce zadaná v parametru Akce se vztahuje na všechny zarážky.

PS C:\> Set-PSBreakpoint -Script "sample.ps1" -Line 1, 14, 19 -Column 2 -Action {&(log.ps1)}

Column     : 2
Line       : 1
Action     :
Enabled    : True
HitCount   : 0
Id         : 6
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1


Column     : 2
Line       : 14
Action     :
Enabled    : True
HitCount   : 0
Id         : 7
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1


Column     : 2
Line       : 19
Action     :
Enabled    : True
HitCount   : 0
Id         : 8
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

Příklad 8: Nastavení zarážky v prostředí runspace

V tomto příkladu se spustí úloha. Runspace je uložen v proměnné a předán do Set-PSBreakPoint příkazu s parametrem Runspace .

Start-Job -ScriptBlock {
    Start-Sleep -Seconds 10
}

$runspace = Get-Runspace -Id 1

Set-PSBreakpoint -Command Start-Sleep -Runspace $runspace

Parametry

-Action

-Column

-Command

-Line

-Mode

-Runspace

-Script

-Variable

Vstupy

None

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

Výstupy

CommandBreakpoint

LineBreakpoint

VariableBreakpoint

Set-PSBreakpoint vrátí objekt, který představuje každou zarážku, kterou nastaví.

Poznámky

PowerShell obsahuje následující aliasy pro Set-PSBreakpoint:

• Všechny platformy:

  • sbp

• Set-PSBreakpoint Aplikace nemůže nastavit zarážku ve vzdáleném počítači. Pokud chcete ladit skript na vzdáleném počítači, zkopírujte skript do místního počítače a potom ho místně ladit.

• Když nastavíte zarážku na více než jeden řádek, příkaz nebo proměnnou, Set-PSBreakpoint vygeneruje objekt zarážky pro každou položku.

• Při nastavování zarážky na funkci nebo proměnné na příkazovém řádku můžete zarážku nastavit před nebo po vytvoření funkce nebo proměnné.

Související odkazy

• Disable-PSBreakpoint
• Enable-PSBreakpoint
• Get-PSBreakpoint
• Get-PSCallStack
• Remove-PSBreakpoint