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

语法

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






另请参阅




目录