当前位置:网站首页 > 更多 > 玩电脑 > 正文

[玩转系统] 禁用 PSBreakpoint (Microsoft.PowerShell.Utility)

作者:精品下载站 日期:2024-12-14 02:08:00 浏览:15 分类:玩电脑

禁用 PSBreakpoint (Microsoft.PowerShell.Utility)


禁用 PSBreakpoint

模块 :Microsoft.PowerShell.Utility

禁用当前控制台中的断点。

句法

Disable-PSBreakpoint
       [-PassThru]
       [-Breakpoint] <Breakpoint[]>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Disable-PSBreakpoint
       [-PassThru]
       [-Id] <Int32[]>
       [-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。

示例

示例1:设置断点并禁用它

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

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

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

此命令的结果是,$B 中断点对象的 Enabled 属性值为 False

示例 2:禁用断点

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

Disable-PSBreakpoint -Id 0

示例 3:创建禁用断点

此命令创建一个新断点,在您启用它之前该断点将被禁用。

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

它使用 Disable-PSBreakpoint cmdlet 来禁用断点。 Breakpoint参数的值为Set-PSBreakpoint命令,用于设置新断点,生成断点对象,并将该对象保存在$B中。代码>变量。

将对象作为其值的 Cmdlet 参数可以接受包含该对象的变量或获取或生成该对象的命令。在这种情况下,因为Set-PSBreakpoint生成一个断点对象,所以它可以用作Breakpoint参数的值。

示例4:禁用当前控制台中的所有断点

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

`Get-PSBreakpoint` | Disable-PSBreakpoint

示例 5:禁用运行空间中的断点

在此示例中,启动作业并设置断点以在运行 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

参数

-Breakpoint

指定要禁用的断点。输入包含断点对象的变量或获取断点对象的命令,例如 Get-PSBreakpoint 命令。您还可以通过管道将断点对象传递给 Disable-PSBreakpoint cmdlet。

类型 :

断点[]

位置:

0

默认值:

None

必需的:

True

接受管道输入:

True

接受通配符:

False

-Confirm

在运行 cmdlet 之前提示您进行确认。

类型 :

SwitchParameter

别名:

cf

位置:

命名

默认值:

False

必需的:

False

接受管道输入:

False

接受通配符:

False

-Id

禁用具有指定断点 ID 的断点。输入 ID 或包含 ID 的变量。您无法通过管道将 ID 传递给 Disable-PSBreakpoint

类型 :

Int32[]

位置:

0

默认值:

None

必需的:

True

接受管道输入:

True

接受通配符:

False

-PassThru

返回一个表示已启用断点的对象。默认情况下,此 cmdlet 不生成任何输出。

类型 :

SwitchParameter

位置:

命名

默认值:

None

必需的:

False

接受管道输入:

False

接受通配符:

False

-Runspace

指定运行空间对象的 ID,以便您可以与指定运行空间中的断点进行交互。

此参数是在 PowerShell 7.2 中添加的。

类型 :

运行空间

别名:

RunspaceId

位置:

命名

默认值:

None

必需的:

False

接受管道输入:

True

接受通配符:

False

-WhatIf

显示 cmdlet 运行时会发生什么情况。该 cmdlet 未运行。

类型 :

SwitchParameter

别名:

wi

位置:

命名

默认值:

False

必需的:

False

接受管道输入:

False

接受通配符:

False

输入

断点

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

输出

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

断点

当您使用 PassThru 参数时,此 cmdlet 将返回一个表示禁用断点的断点对象。

笔记

PowerShell 包含以下 Disable-PSBreakpoint 别名:

  • 所有平台:

      dbp

    您需要 登录账户 后才能发表评论

    取消回复欢迎 发表评论:

    关灯