Remove-PSBreakpoint

项目
10/30/2009

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

语法

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。

输出

无

该 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 配置文件中。

另请参阅

概念

about_Debuggers
Set-PSBreakpoint
Get-PSBreakpoint
Enable-PSBreakpoint
Disable-PSBreakpoint
Get-PSCallStack

通过