Remove-PSBreakpoint

  • 参考
模块:
Microsoft.PowerShell.Utility

从当前控制台中删除断点。

语法

Remove-PSBreakpoint
      [-Breakpoint] <Breakpoint[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-PSBreakpoint
      [-Id] <Int32[]>
      [-Runspace <Runspace>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

说明

Remove-PSBreakpoint cmdlet 用于删除断点。 输入一个断点对象或断点 ID。

当你删除断点时，断点对象将不再可用或无法正常工作。 如果你已将断点对象保存在变量中，则引用仍然存在，但该断点无法正常工作。

Remove-PSBreakpoint 是专门用于调试 PowerShell 脚本的多个 cmdlet 之一。 有关 PowerShell 调试程序的详细信息，请参阅 about_Debuggers。

示例

示例 1：删除所有断点

此命令将删除当前控制台中的所有断点。

Get-PSBreakpoint | Remove-PSBreakpoint

示例 2：删除指定断点

此命令将删除断点。

$B = Set-PSBreakpoint -Script "sample.ps1" -Variable "Name"
$B | Remove-PSBreakpoint

Set-PSBreakpoint cmdlet 在 Sample.ps1 脚本中的 $Name 变量上创建断点，并将断点对象保存在 $B 变量中。 Remove-PSBreakpoint cmdlet 删除新断点。 它使用管道运算符 (|) 将 $B 变量中的断点对象发送到 Remove-PSBreakpoint cmdlet。

此命令的结果是：如果你运行该脚本，则它将一直运行直至完成。 此外，Get-PSBreakpoint cmdlet 不会返回此断点。

示例 3：按 ID 删除断点

此命令将删除断点 ID 为 2 的断点。

Remove-PSBreakpoint -Id 2

示例 4：使用函数删除所有断点

此简单函数将删除当前会话中的所有断点。

function del-psb { Get-PSBreakpoint | Remove-PSBreakpoint }

它使用 Get-PSBreakpoint cmdlet 来获取断点。 然后，它使用管道运算符 (|) 将这些断点发送到 Remove-PSBreakpoint cmdlet，后者将它们删除。

示例 5：在运行空间中移除断点

在此示例中，将启动一个作业，并将一个断点设置为当运行 Set-PSBreakPoint 时中断。 运行空间存储在变量中，并通过“运行空间”参数传递到 Get-PSBreakPoint 命令。 Get-PSBreakPoint 的输出通过管道传递给 Remove-PSBreakpoint 以在运行空间中移除该断点。

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

$runspace = Get-Runspace -Id 1

Get-PSBreakPoint -Runspace $runspace | Remove-Breakpoint -Runspace $runspace

参数

-Breakpoint

指定要删除的断点。 输入一个包含断点对象的变量或可获取断点对象的命令（如 Get-PSBreakpoint 命令）。 还可以通过管道将断点对象传递给 Remove-PSBreakpoint。

Type:Breakpoint[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

提示你在运行 cmdlet 之前进行确认。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

指定此 cmdlet 为其删除断点的断点 ID。

Type:Int32[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Runspace

指定 Runspace 对象的 ID，以便可以在指定的运行空间中与断点进行交互。

此参数已在 PowerShell 7.2 中添加。

Type:Runspace
Aliases:RunspaceId
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

输入

Breakpoint[]

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

Int32[]

Runspace

输出

None

此 cmdlet 不返回任何输出。

备注

PowerShell 包含 Remove-PSBreakpoint 的以下别名：

  • 所有平台：
    • rbp