Ruft die Haltepunkte ab, die in der aktuellen Sitzung festgelegt sind.
Syntax
Get-PSBreakpoint [[-Script] <string[]>] [<CommonParameters>] Get-PSBreakpoint -Command <string[]> [-Script <string[]>] [<CommonParameters>] Get-PSBreakpoint [-Id] <Int32[]> [<CommonParameters>] Get-PSBreakpoint [-Typ] <BreakpointType[]> [-Script <string[]>] [<CommonParameters>] Get-PSBreakpoint -Variable <string[]> [-Script <string[]>] [<CommonParameters>]
Beschreibung
Mit dem Cmdlet "Get-PSBreakPoint" werden die Haltepunkte abgerufen, die in der aktuellen Sitzung festgelegt sind. Sie können bestimmte Haltepunkte mithilfe der Cmdlet-Parameter abrufen.
Ein Haltepunkt ist ein Punkt in einem Befehl oder Skript, an dem die Ausführung unterbrochen wird, damit Sie die Anweisungen untersuchen können. Get-PSBreakpoint ist eines von mehreren Cmdlets zum Debuggen von Windows PowerShell-Skripten und -Befehlen. Weitere Informationen über den Windows PowerShell-Debugger finden Sie unter "about_Debuggers".
Parameter
-Command <string[]>
Ruft Befehlshaltepunkte ab, die auf die angegebenen Befehlsnamen festgelegt sind. Geben Sie die Befehlsnamen, z. B. den Namen eines Cmdlet oder einer Funktion, ein.
|
Erforderlich? |
true |
|
Position? |
named |
|
Standardwert |
All breakpoints |
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Id <Int32[]>
Ruft die Haltepunkte mit den angegebenen Haltepunkt-IDs ab. Geben Sie die IDs in einer durch Trennzeichen getrennten Liste ein. Sie können Haltepunkt-IDs auch über die Pipeline an Get-PSBreakpoint übergeben.
|
Erforderlich? |
true |
|
Position? |
1 |
|
Standardwert |
All breakpoints |
|
Pipelineeingaben akzeptieren? |
true (ByValue) |
|
Platzhalterzeichen akzeptieren? |
false |
-Script <string[]>
Ruft nur die Haltepunkte in den angegebenen Skripts ab. Geben Sie Pfad (optional) und Namen einer oder mehrerer Skriptdateien ein. Der Standardspeicherort ist das aktuelle Verzeichnis.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
All breakpoints |
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Typ <BreakpointType[]>
Ruft nur Haltepunkte der angegebenen Typen ab. Geben Sie einen oder mehrere Typen ein. Gültige Werte sind "Line", "Command" und "Variable". Sie können Haltepunkttypen auch über die Pipeline an Get-PSBreakpoint übergeben.
|
Erforderlich? |
true |
|
Position? |
1 |
|
Standardwert |
All breakpoints |
|
Pipelineeingaben akzeptieren? |
true (ByValue) |
|
Platzhalterzeichen akzeptieren? |
false |
-Variable <string[]>
Ruft Variablenhaltepunkte ab, die auf die angegebenen Variablennamen festgelegt sind. Geben Sie die Variablennamen ohne Dollarzeichen ein.
|
Erforderlich? |
true |
|
Position? |
named |
|
Standardwert |
All breakpoints |
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.
Eingaben und Ausgaben
Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.
|
Eingaben |
System.Int32, Microsoft.PowerShell.Commands.BreakpointType Sie können Haltepunkt-IDs und Haltepunkttypen über die Pipeline an Get-PSBreakpoint übergeben. |
|
Ausgaben |
Haltepunktobjekt (System.Management.Automation.LineBreakpoint, System.Management.Automation.VariableBreakpoint, System.Management.Automation.CommandBreakpoint) Get-PSBreakPoint gibt Objekte zurück, die die Haltepunkte in der Sitzung darstellen. |
Hinweise
Sie können Get-PSBreakpoint oder den zugehörigen Alias "gbp" verwenden.
Beispiel 1
C:\PS>get-psbreakpoint Beschreibung ----------- Mit diesem Befehl werden alle Haltepunkte abgerufen, die für alle Skripts und Funktionen in der aktuellen Sitzung festgelegt sind.
Beispiel 2
C:\PS>get-psbreakpoint -Id 2 Function : Increment Action : Enabled : True HitCount : 0 Id : 2 Script : C:\ps-test\sample.ps1 ScriptName : C:\ps-test\sample.ps1 Beschreibung ----------- Mit diesem Befehl wird der Haltepunkt mit der Haltepunkt-ID 2 abgerufen.
Beispiel 3
C:\PS>$b = set-psbreakpoint -script sample.ps1 -function increment C:\PS> $b.Id | get-psbreakpoint Beschreibung ----------- Diese Befehle veranschaulichen, wie ein Haltepunkt durch Übergeben einer Haltepunkt-ID über die Pipeline an Get-PSBreakpoint abgerufen wird. Im ersten Befehl wird das Cmdlet "Set-PSBreakpoint" verwendet, um einen Haltepunkt für die Increment-Funktion im Skript "Sample.ps1" zu erstellen. Das Haltepunktobjekt wird in der Variablen "$b" gespeichert. Im zweiten Befehl wird die Id-Eigenschaft des Haltepunktobjekts in der Variablen "$b" mithilfe des Punktoperators (.) abgerufen. Die ID wird mit einem Pipelineoperator (|) an das Cmdlet "Get-PSBreakpoint" gesendet. Daher ruft Get-PSBreakpoint den Haltepunkt mit der angegebenen ID ab.
Beispiel 4
C:\PS>get-psbreakpoint -script Sample.ps1, SupportScript.ps1 Beschreibung ----------- Mit diesem Befehl werden alle Haltepunkte in den Dateien "Sample.ps1" und "SupportScript.ps1" abgerufen. Dieser Befehl ruft keine anderen Haltepunkte ab, die eventuell in anderen Skripts oder für Funktionen in der Sitzung festgelegt sind.
Beispiel 5
C:\PS>get-psbreakpoint -command Read-Host, Write-Host -script Sample.ps1 Beschreibung ----------- Mit diesem Befehl werden alle Befehlshaltepunkte abgerufen, die für den Befehl "Read-Host" oder "Write-Host" in der Datei "Sample.ps1" festgelegt sind.
Beispiel 6
C:\PS>get-psbreakpoint -type Command -script Sample.ps1 Beschreibung ----------- Mit diesem Befehl werden alle Befehlshaltepunkte in der Datei "Sample.ps1" abgerufen.
Beispiel 7
C:\PS>get-psbreakpoint -variable Index, Swap Beschreibung ----------- Mit diesem Befehl werden alle Haltepunkte abgerufen, die für die Variablen "$index" und "$swap"in der aktuellen Sitzung festgelegt sind.
Beispiel 8
C:\PS>get-psbreakpoint -type line, variable -script Sample.ps1 Beschreibung ----------- Mit diesem Befehl werden alle Zeilen- und Variablenhaltepunkte im Skript "Sample.ps1" abgerufen.
Siehe auch