删除当前控制台中的断点。
语法
Remove-PSBreakpoint [-Id] <Int32[]> [-Confirm] [-WhatIf] [<CommonParameters>] Remove-PSBreakpoint [-Breakpoint] <Breakpoint[]> [-Confirm] [-WhatIf] [<CommonParameters>]
说明
Remove-PSBreakpoint cmdlet 可以删除断点。请输入断点对象或断点 ID。
删除断点时，断点对象不再可用或不再发生作用。如果已在变量中保存了断点对象，则该引用仍存在，但该断点不再发生作用。
Remove-PSBreakpoint 是专门用来调试 Windows PowerShell 脚本的多个 cmdlet 之一。有关 Windows PowerShell 调试程序的详细信息，请参阅 about_Debuggers。
参数
-Breakpoint <Breakpoint[]>
指定要删除的断点。输入包含断点对象的变量或者用来获取断点对象的命令（如 Get-PSBreakpoint 命令）。也可以通过管道将断点对象传递给 Remove-PSBreakpoint。
|
是否为必需？ |
true |
|
位置？ |
1 |
|
默认值 |
无 |
|
是否接受管道输入？ |
true (ByValue) |
|
是否接受通配符？ |
false |
-Id <Int32[]>
删除具有指定断点 ID 的断点。
|
是否为必需？ |
true |
|
位置？ |
1 |
|
默认值 |
无 |
|
是否接受管道输入？ |
true (ByPropertyName) |
|
是否接受通配符？ |
false |
-Confirm
在执行命令之前提示您进行确认。
|
是否为必需？ |
false |
|
位置？ |
named |
|
默认值 |
|
|
是否接受管道输入？ |
false |
|
是否接受通配符？ |
false |
-WhatIf
描述如果执行该命令会发生什么情况（无需实际执行该命令）。
|
是否为必需？ |
false |
|
位置？ |
named |
|
默认值 |
|
|
是否接受管道输入？ |
false |
|
是否接受通配符？ |
false |
<CommonParameters>
此 cmdlet 支持通用参数：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息，请参阅 about_Commonparameters.
输入和输出
输入类型是指可通过管道传递给 cmdlet 的对象的类型。返回类型是指 Cmdlet 所返回对象的类型。
|
输入 |
System.Management.Automation.Breakpoint 可以通过管道将断点对象传递给 Remove-PSBreakpoint。 |
|
输出 |
None 该 cmdlet 不产生任何输出。 |
示例 1
C:\PS>get-breakpoint | remove-breakpoint 说明 ----------- 此命令删除当前控制台中的所有断点。
示例 2
C:\PS>$b = set-psbreakpoint -script sample.ps1 -variable Name C:\PS> $b | remove-psbreakpoint 说明 ----------- 此命令可以删除断点。 第一个命令使用 Set-PSBreakpoint cmdlet 在 Sample.ps1 脚本中的 Name 变量上创建断点。然后，它将断点对象保存在 $b 变量中。 第二个命令使用 Remove-PSBreakpoint cmdlet 来删除新断点。它使用管道运算符 (|) 将 $b 变量中的断点对象发送至 Remove-PSBreakpoint cmdlet。 此命令的结果是，如果您运行脚本，该脚本将运行直到完成，中间不停止。另外，Get-PSBreakpoint cmdlet 不返回此断点。
示例 3
C:\PS>remove-psbreakpoint -id 2 说明 ----------- 此命令删除断点 ID 为 2 的断点。
示例 4
C:\PS>function del-psb { get-psbreakpoint | remove-psbreakpoint }
说明
-----------
此简单函数删除当前控制台中的所有断点。它使用 Get-PSBreakpoint cmdlet 来获取断点。然后，它使用管道运算符 (|) 将断点发送到 Remove-PSBreakpoint cmdlet，该 cmdlet 将删除这些断点。
结果，您可以键入“del-psb”，而不用键入更长的命令。
若要保存该函数，请将其添加到 Windows PowerShell 配置文件中。
另请参阅