禁用当前控制台中的断点。
语法
Disable-PSBreakpoint [-Id] <Int32[]> [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>] Disable-PSBreakpoint [-Breakpoint] <Breakpoint[]> [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
说明
Disable-PSBreakpoint cmdlet 禁用断点，以确保在脚本运行时不会命中断点。可使用它来禁用所有断点，或者可通过提交断点对象或断点 ID 来指定断点。
在技术上，该 cmdlet 将断点对象的 Enabled 属性值更改为 False。要重新启用断点，请使用 Enable-PSBreakpoint cmdlet。当使用 Set-PSBreakpoint cmdlet 来创建断点时，将默认启用断点。
断点是脚本中的一个点，在该处，将暂时停止执行脚本，从而使您可以检查脚本中的指令。Disable-PSBreakpoint 是设计用来调试 Windows PowerShell 脚本的多个 cmdlet 之一。有关 Windows PowerShell 调试程序的详细信息，请参阅 about_Debuggers。
参数
-Breakpoint <Breakpoint[]>
指定要禁用的断点。输入包含断点对象的变量或者用来获取断点对象的命令（如 Get-PSBreakpoint 命令）。还可通过管道将断点对象传递至 Disable-PSBreakpoint cmdlet。
|
是否为必需？ |
true |
|
位置？ |
1 |
|
默认值 |
无 |
|
是否接受管道输入？ |
true (ByValue) |
|
是否接受通配符？ |
false |
-Id <Int32[]>
禁用具有指定断点 ID 的断点。输入 ID 或包含 ID 的变量。无法通过管道将 ID 传递至 Disable-PSBreakpoint。
|
是否为必需？ |
true |
|
位置？ |
1 |
|
默认值 |
|
|
是否接受管道输入？ |
true (ByPropertyName) |
|
是否接受通配符？ |
false |
-PassThru
返回表示已启用的断点的对象。默认情况下，此 cmdlet 将不产生任何输出。
|
是否为必需？ |
false |
|
位置？ |
named |
|
默认值 |
无 |
|
是否接受管道输入？ |
false |
|
是否接受通配符？ |
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 可通过管道将断点对象传递至 Disable-PSBreakpoint。 |
|
输出 |
None 或 System.Management.Automation.Breakpoint 如果使用 PassThru 参数，则 Disable-PSBreakpoint 返回一个表示被禁用断点的对象。否则，此 cmdlet 将不产生任何输出。 |
示例 1
C:\PS>$b = set-psbreakpoint -script sample.ps1 -variable name C:\PS> $b | disable-psbreakpoint 说明 ----------- 这些命令禁用新创建的断点。 第一个命令使用 Set-PSBreakpoint cmdlet 在 Sample.ps1 脚本中的 Name 变量上创建断点。然后，它将断点对象保存在 $b 变量中。 第二条命令使用 Disable-PSBreakpoint cmdlet 来禁用新断点。它使用管道运算符 (|) 将 $b 中的断点对象发送至 Disable-PSBreakpoint cmdlet。 此命令的结果是：$b 中断点对象的 Enabled 属性值是 False。
示例 2
C:\PS>disable-psbreakpoint -id 0 说明 ----------- 此命令禁用断点 ID 为 0 的断点。
示例 3
C:\PS>disable-psbreakpoint -breakpoint ($b = set-psbreakpoint -script sample.ps1 -line 5) C:\PS> $b 说明 ----------- 此命令创建新断点，在您启用该断点之前，该断点将一直禁用。 此命令使用 Disable-PSBreakpoint cmdlet 来禁用断点。Breakpoint 参数的值为 Set-PSBreakpoint 命令，该命令可设置新断点、生成断点对象，并将对象保存在 $b 变量中。 Cmdlet 参数以对象作为值，可接受包含对象的变量，或者是可以获取或生成对象的命令。在此情况下，由于 Set-PSBreakpoint 生成断点对象，因此它可作为 Breakpoint 参数的值来使用。 第二条命令显示 $b 变量值中的断点对象。
示例 4
C:\PS>get-psbreakpoint | disable-psbreakpoint 说明 ----------- 此命令禁用当前控制台中的所有断点。可将此命令缩写为：“gbp | dbp”。
另请参阅