Ruft die Haltepunkte ab, die in der aktuellen Sitzung festgelegt sind. (Get-PSBreakpoint)
NAMEGet-PSBreakpointÜBERSICHTRuft die Haltepunkte ab, die in der aktuellen Sitzung festgelegt sind.SYNTAXGet-PSBreakpoint [[-Script] <string[]>] [<CommonParameters>] Get-PSBreakpoint -Command <string[]> [-Script <string[]>] [<CommonParameters>] Get-PSBreakpoint [-Id] <Int32[]> [<CommonParameters>] Get-PSBreakpoint [-Type] <BreakpointType[]> [-Script <string[]>] [<CommonParameters>] Get-PSBreakpoint -Variable <string[]> [-Script <string[]>] [<CommonParameters>]BESCHREIBUNGMit 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 Alle Haltepunkte 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 Alle Haltepunkte 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 Alle Haltepunkte Pipelineeingaben akzeptieren?false Platzhalterzeichen akzeptieren?false -Type <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 Alle Haltepunkte 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 Alle Haltepunkte Pipelineeingaben akzeptieren?false Platzhalterzeichen akzeptieren?false <CommonParameters> Dieses Cmdlet unterstützt folgende allgemeine Parameter: "Verbose", "Debug", "ErrorAction", "ErrorVariable", "WarningAction", "WarningVariable", "OutBuffer" und "OutVariable". Weitere Informationen erhalten Sie mit dem Befehl "get-help about_commonparameters".EINGABENSystem.Int32, Microsoft.PowerShell.Commands.BreakpointType Sie können Haltepunkt-IDs und Haltepunkttypen über die Pipeline an Get-PSBreakpoint übergeben.AUSGABENHaltepunktobjekt (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.HINWEISESie können Get-PSBreakpoint oder den zugehörigen Alias "gbp" verwenden.Beispiele
BEISPIEL 1C:\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 2C:\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 3C:\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 4C:\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 5C:\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 6C:\PS>get-psbreakpoint -type Command -script Sample.ps1 Beschreibung ----------- Mit diesem Befehl werden alle Befehlshaltepunkte in der Datei "Sample.ps1" abgerufen.BEISPIEL 7C:\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 8C:\PS>get-psbreakpoint -type line, variable -script Sample.ps1 Beschreibung ----------- Mit diesem Befehl werden alle Zeilen- und Variablenhaltepunkte im Skript "Sample.ps1" abgerufen. VERWANDTE LINKS Online version: http://go.microsoft.com/fwlink/?LinkID=113325 (möglicherweise auf Englisch) about_Debuggers Set-PSBreakpoint Disable-PSBreakpoint Enable-PSBreakpoint Remove-PSBreakpoint Get-PSCallStack C:\Windows>powershell get-help Remove-PSBreakpoint -full
Microsoft Windows [Version 10.0.19045.3693]
Copyright (c) 2023 Microsoft Corporation.
ColorConsole [Version 3.7.1000] PowerShell 2.0-Export
