Set-PSBreakpoint

Set-PSBreakpoint -Command <string[]> [[-Script] <string[]>] [-Action <scriptblock>] [<CommonParameters>]

Set-PSBreakpoint [-Script] <string[]> [-Line] <Int32[]> [[-Column] <int>] [-Action <scriptblock>] [<CommonParameters>]

Set-PSBreakpoint -Variable <string[]> [[-Script] <string[]>] [-Mode {<Read> | <Write> | <ReadWrite>}] [-Action <scriptblock>] [<CommonParameters>]

C:\PS>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

Beschreibung
-----------
Mit diesem Befehl wird ein Haltepunkt im Skript "Sample.ps1" in Zeile 5 festgelegt. Folglich wird die Ausführung des Skripts direkt vor Zeile 5 angehalten.

Wenn Sie einen neuen Haltepunkt nach Zeilennummer festlegen, generiert das Cmdlet "Set-PSBreakpoint" ein Zeilenhaltepunktobjekt (System.Management.Automation.LineBreakpoint), das die Haltepunkt-ID und die Trefferanzahl enthält, wie in der folgenden Beispielausgabe angezeigt.

C:\PS>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

Beschreibung
-----------
Mit diesem Befehl wird ein Befehlshaltepunkt für die Increment-Funktion im Skript "Sample.ps1" erstellt. Die Ausführung des Skripts wird direkt vor jedem Aufruf der angegebenen Funktion angehalten.

Das Ergebnis ist ein Befehlshaltepunktobjekt. Vor der Ausführung des Skripts ist der Wert der HitCount-Eigenschaft 0.

C:\PS>set-psbreakpoint -script sample.ps1 -variable Server -Mode ReadWrite

Beschreibung
-----------
Mit diesem Befehl wird ein Haltepunkt für die Variable "Server" im Skript "Sample.ps1" festgelegt. Er verwendet den Mode-Parameter mit dem Wert "ReadWrite", um die Ausführung direkt vor dem Ändern des Werts der Variablen sowie beim Lesen des Werts zu beenden.

C:\PS>set-psbreakpoint -script Sample.ps1 -command "write*"

Beschreibung
-----------
Mit diesem Befehl wird ein Haltepunkt für jeden Befehl im Skript "Sample.ps1" festgelegt, der mit "write" beginnt, z. B. "write-host".

C:\PS>set-psbreakpoint -script test.ps1 -command DiskTest `
  -action { (if $disk -gt 2) { break } }

Beschreibung
-----------
Mit diesem Befehl wird die Ausführung an der Funktion "DiskTest" im Skript "Test.ps1" nur beendet, wenn der Wert der Variablen "$disk" größer als 2 ist.

Mit dem Cmdlet "Set-PSBreakpoint" wird ein Befehlshaltepunkt für die Funktion "DiskTest" festgelegt. Der Wert der Aktion ist ein Skriptblock, mit dem der Wert der Variablen "$disk" in der Funktion überprüft wird.

Die Aktion beendet die Ausführung mithilfe des BREAK-Schlüsselworts, wenn die Bedingung erfüllt ist. Die Alternative (und der Standardwert) ist CONTINUE.

C:\PS>set-psbreakpoint -command checkpoint-computer

Id       : 0
Command  : checkpoint-computer
Enabled  : True
HitCount : 0
Action   :

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

Beschreibung
-----------
Mit diesem Befehl wird ein Haltepunkt für die Funktion "CheckLog" festgelegt. Da der Befehl kein Skript angibt, wird der Haltepunkt für jedes in der aktuellen Sitzung ausgeführte Element festgelegt. Der Debugger wird unterbrochen, wenn die Funktion aufgerufen wird, nicht wenn sie deklariert wird.

C:\PS>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

Beschreibung
-----------
Mit diesem Befehl werden drei Zeilenhaltepunkte im Skript "Sample.ps1" festgelegt. Für jede angegebene Zeile im Skript wird ein Haltepunkt in Spalte 2 festgelegt. Die im Action-Parameter angegebene Aktion wird auf alle Haltepunkte angewendet.