Share via

Get-PSBreakpoint

  • Referenz
Modul:
Microsoft.PowerShell.Utility

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
   -Variable <string[]>
   [-Script <string[]>]
   [<CommonParameters>]
Get-PSBreakpoint
   [-Type] <BreakpointType[]>
   [-Script <string[]>]
   [<CommonParameters>]
Get-PSBreakpoint
   [-Id] <int[]>
   [<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übergeben.

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

Das Set-PSBreakpoint Cmdlet erstellt einen Haltepunkt für die Inkrementfunktion 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 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"

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

Beispiel 5: Abrufen von Haltepunkten in angegebenen Cmdlets

Mit diesem Befehl werden alle Command-Haltepunkte 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 Befehls-Haltepunkten 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

Mit diesem Befehl werden Haltepunkte abgerufen, 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 Variablen-Haltepunkte in einer Datei

Mit diesem Befehl werden alle Zeilen- und Variablen-Haltepunkte im Sample.ps1 Skript abgerufen.

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

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 erhält. Geben Sie die IDs in einer durch Trennzeichen getrennten Liste ein. Sie können auch Breakpoint-IDs an Get-PSBreakpointübergeben.

Type:Int32[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
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 Get-PSBreakPointübergeben.

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 Variablen-Haltepunkten 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

Int32

BreakpointType

Sie können Breakpoint-IDs und Haltepunkttypen an übergeben Get-PSBreakPoint.

Ausgaben

CommandBreakpoint

LineBreakpoint

VariableBreakpoint

Breakpoint

Get-PSBreakPoint gibt Objekte zurück, die die Haltepunkte in der Sitzung darstellen.

Hinweise

Sie können oder den zugehörigen Alias "gbp" verwenden Get-PSBreakpoint .