Remove-PSBreakpoint
从当前控制台中删除断点。
语法
Remove-PSBreakpoint
[-Breakpoint] <Breakpoint[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-PSBreakpoint
[-Id] <Int32[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
Remove-PSBreakpoint cmdlet 可删除断点。 输入一个断点对象或断点 ID。
当你删除断点时,断点对象将不再可用或无法正常工作。 如果你已将断点对象保存在变量中,则引用仍然存在,但该断点无法正常工作。
Remove-PSBreakpoint 是专门用于调试 Windows PowerShell 脚本的多个 cmdlet 之一。 有关 Windows PowerShell 调试程序的详细信息,请参阅 about_Debuggers。
示例
示例 1:删除所有断点
PS C:\> Get-PSBreakpoint | Remove-PSBreakpoint
此命令将删除当前控制台中的所有断点。
示例 2:删除指定断点
PS C:\> $B = Set-PSBreakpoint -Script "sample.ps1" -Variable "Name"
PS C:\> $B | Remove-PSBreakpoint
此命令将删除断点。
第一个命令使用 Set-PSBreakpoint cmdlet 在 Sample.ps1 脚本中的 Name 变量上创建断点。 然后,它将断点对象保存在 $B 变量中。
第二个命令使用 Remove-PSBreakpoint cmdlet 删除新断点。 它使用管道运算符 (|) 将 $B 变量中的断点对象发送到 Remove-PSBreakpoint cmdlet。
此命令的结果是:如果你运行该脚本,则它将一直运行直至完成。 此外,Get-PSBreakpoint 不会返回此断点。
示例 3:按 ID 删除断点
PS C:\> Remove-PSBreakpoint -Id 2
此命令将删除断点 ID 为 2 的断点。
示例 4:使用函数删除所有断点
PS C:\> function del-psb { get-psbreakpoint | remove-psbreakpoint }
此简单函数将删除当前控制台中的所有断点。 它使用 Get-PSBreakpoint 来获取这些断点。 然后,它使用管道运算符 (|) 将这些断点发送到 Remove-PSBreakpoint cmdlet,后者再将删除它们。
因此,你可以输入 del-psb
,而不是输入更长的命令。
若要保存该函数,请将其添加到你的 Windows PowerShell 配置文件中。
参数
-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 |
-WhatIf
显示运行该 cmdlet 时会发生什么情况。 此 cmdlet 未运行。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
输入
可以通过管道将断点对象传递给 Remove-PSBreakpoint。
输出
None
该 cmdlet 不生成任何输出。