Disable-PSBreakpoint

Disable-PSBreakpoint
    [-Breakpoint] <Breakpoint[]>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Disable-PSBreakpoint
    [-Id] <Int32[]>
    [-PassThru]
    [-Runspace <Runspace>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Disable-PSBreakpoint cmdlet 禁用断点，这可确保脚本运行时不会命中这些断点。 可以使用它禁用所有断点，也可以通过提交断点对象或断点 ID 来指定断点。

从技术上看，此 cmdlet 会将断点对象的 Enabled 属性的值更改为 False。 若要重新启用断点，请使用 Enable-PSBreakpoint cmdlet。 使用 Set-PSBreakpoint cmdlet 创建断点时，默认启用断点。

断点是脚本中的一个点，其中执行会暂时停止，以便检查脚本中的说明。 Disable-PSBreakpoint 是用于调试 PowerShell 脚本的多个 cmdlet 之一。 有关 PowerShell 调试器的详细信息，请参阅 about_Debuggers。

这些命令禁用新建的断点。

$B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
$B | Disable-PSBreakpoint

Set-PSBreakpoint cmdlet 在 $Name 脚本中的 Sample.ps1 变量上创建断点，并将断点对象保存在 $B 变量中。 Disable-PSBreakpoint cmdlet 禁用新的断点。 它使用管道运算符（|）将 $B 中的断点对象发送到 Disable-PSBreakpoint cmdlet。

由于此命令， 中断点对象的 $B 属性的值 False。

此命令禁用断点 ID 为 0 的断点。

Disable-PSBreakpoint -Id 0

此命令将创建一个新的断点，该断点在启用之前处于禁用状态。

Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)

它使用 Disable-PSBreakpoint cmdlet 禁用断点。 断点 参数的值是一个 Set-PSBreakpoint 命令，用于设置新的断点、生成断点对象，并将对象保存在 $B 变量中。

将对象用作其值的 Cmdlet 参数可以接受包含对象或获取或生成对象的命令的变量。 在这种情况下，由于 Set-PSBreakpoint 生成断点对象，因此它可用作 断点 参数的值。

此命令禁用当前控制台中的所有断点。

`Get-PSBreakpoint` | Disable-PSBreakpoint

在此示例中，启动作业，并在运行 Set-PSBreakpoint 时将断点设置为中断。 runspace 存储在变量中，并使用 Get-PSBreakpoint 参数传递给 命令。 Get-PSBreakpoint 的输出通过管道传递给 Disable-PSBreakpoint 以禁用运行空间中的断点。

Start-Job -ScriptBlock {
    Set-PSBreakpoint -Command Start-Sleep
    Start-Sleep -Seconds 10
}

$runspace = Get-Runspace -Id 1

Get-PSBreakpoint -Runspace $runspace | Disable-Breakpoint -Runspace $runspace

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

可以通过管道将断点对象传递给此 cmdlet。

默认情况下，此 cmdlet 不返回任何输出。

使用 PassThru 参数时，此 cmdlet 返回表示禁用断点的断点对象。

PowerShell 包含以下与 Disable-PSBreakpoint相关的别名：

• 所有平台：
  • dbp