Get-PSBreakpoint

Modul:
Microsoft.PowerShell.Utility Module

Ruft die Haltepunkte ab, die in der aktuellen Sitzung festgelegt sind.

Syntax

Line (Standard) 

Get-PSBreakpoint
    [[-Script] <String[]>]
    [-Runspace <Runspace>]
    [<CommonParameters>]

Command 

Get-PSBreakpoint
    [[-Script] <String[]>]
    -Command <String[]>
    [-Runspace <Runspace>]
    [<CommonParameters>]

Variable 

Get-PSBreakpoint
    [[-Script] <String[]>]
    -Variable <String[]>
    [-Runspace <Runspace>]
    [<CommonParameters>]

Type 

Get-PSBreakpoint
    [[-Script] <String[]>]
    [-Type] <BreakpointType[]>
    [-Runspace <Runspace>]
    [<CommonParameters>]

Id 

Get-PSBreakpoint
    [-Id] <Int32[]>
    [-Runspace <Runspace>]
    [<CommonParameters>]

Beschreibung

Das Get-PSBreakpoint Cmdlet ruft die Haltepunkte ab, die in der aktuellen Sitzung festgelegt sind. Mit den Cmdlet-Parametern können Sie bestimmte Haltepunkte abrufen.

Ein Haltepunkt ist ein Punkt in einem Befehl oder Skript, an dem die Ausführung vorübergehend beendet wird, damit Sie die Anweisungen untersuchen können. Get-PSBreakpoint ist eines von mehreren Cmdlets zum Debuggen von PowerShell-Skripts und -Befehlen. Weitere Informationen zum PowerShell-Debugger finden Sie unter about_Debuggers.

Beispiele

Beispiel 1: Abrufen aller Haltepunkte für alle Skripts und Funktionen

Mit diesem Befehl werden alle Haltepunkte abgerufen, die für alle Skripts und Funktionen in der aktuellen Sitzung festgelegt sind.

Get-PSBreakpoint

Beispiel 2: Abrufen von Haltepunkten nach ID

Dieser Befehl ruft den Haltepunkt mit haltepunkt-ID 2 ab.

Get-PSBreakpoint -Id 2

Function         :
IncrementAction  :
Enabled          :
TrueHitCount     : 0
Id               : 2
Script           : C:\ps-test\sample.ps1
ScriptName       : C:\ps-test\sample.ps1

Beispiel 3: Pipen einer ID an "Get-PSBreakpoint"

Diese Befehle zeigen, wie Sie einen Haltepunkt abrufen, indem Sie eine Haltepunkt-ID Get-PSBreakpointan .

$B = `Set-PSBreakpoint` -Script "sample.ps1" -Command "Increment"
$B.Id | Get-PSBreakpoint

Das Set-PSBreakpoint Cmdlet erstellt einen Haltepunkt für die Inkrement-Funktion im Sample.ps1 Skript und speichert das Haltepunktobjekt in der $B Variablen. Die ID-Eigenschaft des Haltepunktobjekts in der $B Variablen wird an das Get-PSBreakpoint Cmdlet weitergeleitet, um die Haltepunktinformationen anzuzeigen.

Beispiel 4: Abrufen von Haltepunkten in angegebenen Skriptdateien

Dieser Befehl ruft alle Haltepunkte in den Sample.ps1 und SupportScript.ps1 Dateien ab.

Get-PSBreakpoint -Script "Sample.ps1, SupportScript.ps1"

Mit diesem Befehl werden keine anderen Haltepunkte abgerufen, die in anderen Skripts oder in Funktionen in der Sitzung festgelegt werden können.

Beispiel 5: Abrufen von Haltepunkten in angegebenen Cmdlets

Dieser Befehl ruft alle Befehlshaltepunkte ab, die in der Sample.ps1 Datei festgelegt Read-Host sind, oder Write-Host Befehle.

Get-PSBreakpoint -Command "Read-Host, Write-Host" -Script "Sample.ps1"

Beispiel 6: Abrufen von Befehlshaltepunkten in einer angegebenen Datei

Get-PSBreakpoint -Type Command -Script "Sample.ps1"

Dieser Befehl ruft alle Befehlshaltepunkte in der Sample.ps1 Datei ab.

Beispiel 7: Abrufen von Haltepunkten nach Variable

Dieser Befehl ruft Haltepunkte ab, die für die $Index und $Swap Variablen in der aktuellen Sitzung festgelegt sind.

Get-PSBreakpoint -Variable "Index, Swap"

Beispiel 8: Abrufen aller Zeilen- und Variablentrennpunkte in einer Datei

Dieser Befehl ruft alle Zeilen- und variablen Haltepunkte im Sample.ps1 Skript ab.

Get-PSBreakpoint -Type Line, Variable -Script "Sample.ps1"

Beispiel 9: Abrufen der haltepunkte, die in einem bestimmten Runspace festgelegt sind

In diesem Beispiel wird ein Auftrag gestartet, und ein Haltepunkt wird festgelegt, wenn der Set-PSBreakpoint Vorgang ausgeführt wird. Der Runspace wird in einer Variablen gespeichert und mit dem parameter Get-PSBreakpoint an den befehl übergeben. Anschließend können Sie den Haltepunkt in der $breakpoint Variablen prüfen.

Start-Job -ScriptBlock {
    Set-PSBreakpoint -Command Start-Sleep
    Start-Sleep -Seconds 10
}

$runspace = Get-Runspace -Id 1

$breakpoint = Get-PSBreakpoint -Runspace $runspace

Parameter

-Command

Gibt ein Array von Befehlshaltepunkten an, die für die angegebenen Befehlsnamen festgelegt sind. Geben Sie die Befehlsnamen ein, z. B. den Namen eines Cmdlets oder einer Funktion.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Command
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Id

Gibt die Haltepunkt-IDs an, die dieses Cmdlet abruft. Geben Sie die IDs in einer durch Trennzeichen getrennten Liste ein. Sie können auch Haltepunkt-IDs an Get-PSBreakpoint.

Parametereigenschaften

Typ:

Int32[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Id
Position:0
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Runspace

Gibt die ID eines Runspace- -Objekts an, sodass Sie mit Haltepunkten im angegebenen Runspace interagieren können.

Dieser Parameter wurde in PowerShell 7.2 hinzugefügt.

Parametereigenschaften

Typ:Runspace
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Script

Gibt ein Array von Skripts an, die die Haltepunkte enthalten. Geben Sie den Pfad (optional) und die Namen einer oder mehrerer Skriptdateien ein. Wenn Sie den Pfad weglassen, ist der Standardspeicherort das aktuelle Verzeichnis.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Script
Position:Named
Obligatorisch.:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
Variable
Position:Named
Obligatorisch.:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
Command
Position:Named
Obligatorisch.:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
Type
Position:Named
Obligatorisch.:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Type

Gibt ein Array von Haltepunkttypen an, das dieses Cmdlet abruft. Geben Sie einen oder mehrere Typen ein. Die zulässigen Werte für diesen Parameter sind:

  • Zeile
  • Befehl
  • Variable

Sie können auch Haltepunkttypen an Get-PSBreakpoint.

Parametereigenschaften

Typ:

BreakpointType[]

Standardwert:None
Zulässige Werte:Line, Variable, Command
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Type
Position:0
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Variable

Gibt ein Array mit variablen Haltepunkten an, die für die angegebenen Variablennamen festgelegt werden. Geben Sie die Variablennamen ohne Dollarzeichen ein.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Variable
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

Int32

Sie können Haltepunkt-IDs an dieses Cmdlet weiterleiten.

BreakpointType

Sie können Haltepunkttypen an dieses Cmdlet weiterleiten.

Ausgaben

CommandBreakpoint

LineBreakpoint

VariableBreakpoint

Breakpoint

Dieses Cmdlet gibt Objekte zurück, die die Haltepunkte in der Sitzung darstellen.

Hinweise

PowerShell enthält die folgenden Aliase für Get-PSBreakpoint:

  • Alle Plattformen:
    • gbp