Get-PSBreakpoint

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>]

Get-PSBreakpoint cmdlet 获取在当前会话中设置的断点。 可以使用 cmdlet 参数获取特定的断点。

断点是命令或脚本中的一个点，其中执行会暂时停止，以便检查说明。 Get-PSBreakpoint 是用于调试 PowerShell 脚本和命令的多个 cmdlet 之一。 有关 PowerShell 调试器的详细信息，请参阅 about_Debuggers。

此命令获取在当前会话中的所有脚本和函数上设置的所有断点。

Get-PSBreakpoint

此命令获取断点 ID 为 2 的断点。

Get-PSBreakpoint -Id 2

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

这些命令演示如何通过将断点 ID 管道传递给 Get-PSBreakpoint来获取断点。

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

Set-PSBreakpoint cmdlet 在 Sample.ps1 脚本中的 Increment 函数上创建断点，并将断点对象保存在 $B 变量中。 变量中断点对象的 $B 属性通过管道传递给 Get-PSBreakpoint cmdlet 以显示断点信息。

此命令获取 Sample.ps1 和 SupportScript.ps1 文件中的所有断点。

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

此命令不会获取可能在其他脚本或会话中的函数上设置的其他断点。

此命令获取在 Read-Host 文件中 Write-Host 或 Sample.ps1 命令上设置的所有命令断点。

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

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

此命令获取 Sample.ps1 文件中的所有命令断点。

此命令获取在当前会话中的 $Index 和 $Swap 变量上设置的断点。

Get-PSBreakpoint -Variable "Index, Swap"

此命令获取 Sample.ps1 脚本中的所有行断点和变量断点。

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

在此示例中，启动作业，并在运行 Set-PSBreakpoint 时将断点设置为中断。 runspace 存储在变量中，并使用 Get-PSBreakpoint 参数传递给 命令。 然后，可以在 $breakpoint 变量中检查断点。

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

$runspace = Get-Runspace -Id 1

$breakpoint = Get-PSBreakpoint -Runspace $runspace

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

可以通过管道将断点 ID 传递给此 cmdlet。

可以通过管道将断点类型传递给此 cmdlet。

此 cmdlet 返回表示会话中的断点的对象。

PowerShell 包含以下与 Get-PSBreakpoint相关的别名：

• 所有平台：
  • gbp