Get-PSBreakpoint
Ruft die Haltepunkte ab, die in der aktuellen Sitzung festgelegt sind.
Syntax
Get-PSBreakpoint
[[-Script] <String[]>]
[-Runspace <Runspace>]
[<CommonParameters>]
Get-PSBreakpoint
[[-Script] <String[]>]
-Command <String[]>
[-Runspace <Runspace>]
[<CommonParameters>]
Get-PSBreakpoint
[[-Script] <String[]>]
-Variable <String[]>
[-Runspace <Runspace>]
[<CommonParameters>]
Get-PSBreakpoint
[[-Script] <String[]>]
[-Type] <BreakpointType[]>
[-Runspace <Runspace>]
[<CommonParameters>]
Get-PSBreakpoint
[-Id] <Int32[]>
[-Runspace <Runspace>]
[<CommonParameters>]
Beschreibung
Das Get-PSBreakPoint
Cmdlet ruft die Haltepunkte ab, die in der aktuellen Sitzung festgelegt sind. Mithilfe der Cmdlet-Parameter 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 lesen 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
Dieser Befehl ruft alle Haltepunkte ab, 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: Übergeben einer ID an "Get-PSBreakpoint"
Diese Befehle zeigen, wie Sie einen Haltepunkt abrufen, indem Sie eine Haltepunkt-ID an Get-PSBreakpoint
pipieren.
$B = `Set-PSBreakpoint` -Script "sample.ps1" -Command "Increment"
$B.Id | Get-PSBreakpoint
Das Set-PSBreakpoint
Cmdlet erstellt einen Haltepunkt für die Increment-Funktion im Sample.ps1
Skript und speichert das Breakpointobjekt in der $B
Variablen. Die Id-Eigenschaft des Haltepunktobjekts in der $B
Variablen wird an das Get-PSBreakpoint
Cmdlet weitergeleitet, um die Breakpointinformationen anzuzeigen.
Beispiel 4: Abrufen von Haltepunkten in angegebenen Skriptdateien
Mit diesem Befehl werden alle Haltepunkte in den Sample.ps1
Dateien und SupportScript.ps1
abgerufen.
Get-PSBreakpoint -Script "Sample.ps1, SupportScript.ps1"
Dieser Befehl ruft keine anderen Haltepunkte ab, die möglicherweise in anderen Skripts oder für Funktionen in der Sitzung festgelegt werden.
Beispiel 5: Abrufen von Haltepunkten in angegebenen Cmdlets
Mit diesem Befehl werden alle Befehlshaltepunkte abgerufen, die für Read-Host
oder Write-Host
in der Sample.ps1
Datei festgelegt sind.
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 Command-Haltepunkte in der Datei „Sample.ps1“ ab.
Beispiel 7: Abrufen von Haltepunkten nach Variable
Dieser Befehl ruft Haltepunkte ab, die für die $Index
Variablen und $Swap
in der aktuellen Sitzung festgelegt sind.
Get-PSBreakpoint -Variable "Index, Swap"
Beispiel 8: Abrufen aller Zeilen- und Variablenhaltepunkte in einer Datei
Mit diesem Befehl werden alle Zeilen- und Variablenhaltepunkte im Sample.ps1
Skript abgerufen.
Get-PSBreakpoint -Type Line, Variable -Script "Sample.ps1"
Beispiel 9: Abrufen der in einem bestimmten Runspace festgelegten Haltepunkte
In diesem Beispiel wird ein Auftrag gestartet und ein Haltepunkt ist für die Ausführung des Set-PSBreakPoint
festgelegt. Der Runspace wird in einer Variablen gespeichert und mit dem Runspace-Parameter an den Get-PSBreakPoint
-Befehl übergeben. Sie können dann den Haltepunkt in der $breakpoint
-Variablen überprü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 werden. Geben Sie die Befehlsnamen ein, z. B. den Namen eines Cmdlets oder einer Funktion.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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 Breakpoint-IDs an übergeben Get-PSBreakpoint
.
Type: | Int32[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Runspace
Gibt die ID eines Runspace-Objekts an, damit Sie mit Haltepunkten im angegebenen Runspace interagieren können.
Dieser Parameter wurde in PowerShell 7.2 hinzugefügt.
Type: | Runspace |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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, wird als Standardspeicherort das aktuelle Verzeichnis verwendet.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Type
Gibt ein Array von Haltepunkttypen an, das dieses Cmdlet abruft. Geben Sie einen oder mehrere Typen ein. Zulässige Werte für diesen Parameter:
- Linie
- Get-Help
- Variable
Sie können auch Breakpointtypen an übergeben Get-PSBreakPoint
.
Type: | BreakpointType[] |
Accepted values: | Line, Variable, Command |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Variable
Gibt ein Array von Variablenhaltepunkten an, die für die angegebenen Variablennamen festgelegt werden. Geben Sie die Variablennamen ohne Dollarzeichen ein.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
Sie können Haltepunkt-IDs an dieses Cmdlet übergeben.
Sie können Breakpointtypen an dieses Cmdlet übergeben.
Ausgaben
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