Remove-PSBreakpoint
从当前控制台中删除断点。
语法
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
。
类型: | Breakpoint[] |
Position: | 0 |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
-Confirm
提示你在运行 cmdlet 之前进行确认。
类型: | SwitchParameter |
别名: | cf |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Id
指定此 cmdlet 为其删除断点的断点 ID。
类型: | Int32[] |
Position: | 0 |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
-Runspace
指定 Runspace 对象的 ID,以便可以在指定的运行空间中与断点进行交互。
此参数已在 PowerShell 7.2 中添加。
类型: | Runspace |
别名: | RunspaceId |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
-WhatIf
显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。
类型: | SwitchParameter |
别名: | wi |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
输入
可以通过管道将断点对象传递给此 cmdlet。
Int32[]
输出
None
此 cmdlet 不返回任何输出。
备注
PowerShell 包含 Remove-PSBreakpoint
的以下别名:
- 所有平台:
rbp