Share via

Enable-PSBreakpoint

  • 参考
模块:
Microsoft.PowerShell.Utility

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

语法

Enable-PSBreakpoint
      [-PassThru]
      [-Breakpoint] <Breakpoint[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Enable-PSBreakpoint
      [-PassThru]
      [-Id] <Int32[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

说明

cmdlet Enable-PSBreakpoint 重新启用禁用的断点。 可以使用它通过提供断点对象或 ID 来启用所有断点或特定断点。

断点是脚本中的一个点，执行会暂时停止，以便可以检查脚本的状态。 新创建的断点会自动启用，但可以使用 禁用 Disable-PSBreakpoint。

从技术上讲，此 cmdlet 将断点对象的 Enabled 属性的值更改为 True。

Enable-PSBreakpoint 是用于调试 PowerShell 脚本的多个 cmdlet 之一。 有关 PowerShell 调试器的详细信息，请参阅 about_Debuggers。

示例

示例 1：启用所有断点

此示例启用当前会话中的所有断点。

Get-PSBreakpoint | Enable-PSBreakpoint

使用别名，此示例可以缩写为 gbp | ebp。

示例 2：按 ID 启用断点

此示例使用断点 ID 启用多个断点。

Enable-PSBreakpoint -Id 0, 1, 5

示例 3：启用禁用的断点

此示例重新启用已禁用的断点。

$B = Set-PSBreakpoint -Script "sample.ps1" -Variable Name -PassThru
$B | Enable-PSBreakpoint -PassThru

AccessMode : Write
Variable   : Name
Action     :
Enabled    : False
HitCount   : 0
Id         : 0
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

AccessMode : Write
Variable   : Name
Action     :
Enabled    : True
HitCount   : 0
Id         : 0
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

Set-PSBreakpoint在将断点对象保存在变量中的脚本中的 Sample.ps1Name 变量上$B创建断点。 PassThru 参数显示断点的 Enabled 属性的值为 False。

Enable-PSBreakpoint 重新启用断点。 同样，使用 PassThru 参数可以看到 Enabled 属性的值为 True。

示例 4：使用变量启用断点

此示例使用断点对象启用一组断点。

$B = Get-PSBreakpoint -Id 3, 5
Enable-PSBreakpoint -Breakpoint $B

Get-PSBreakpoint 获取断点并将其保存在 变量中 $B 。 使用 断点 参数启用 Enable-PSBreakpoint 断点。

此示例等效于运行 Enable-PSBreakpoint -Id 3, 5。

参数

-Breakpoint

指定要启用的断点。 提供包含断点的变量或获取断点对象的命令，例如 Get-PSBreakpoint。 还可以通过管道将断点对象传递给 Enable-PSBreakpoint。

Type:Breakpoint[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

指定要启用的断点的 ID 号。 默认值为所有断点。 按数字或变量提供 ID 。 不能通过管道 将 ID 编号传递给 Enable-PSBreakpoint。 若要查找断点的 ID ，请使用 Get-PSBreakpoint cmdlet。

Type:Int32[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

输入

Breakpoint

可以通过管道将断点对象传递给 Enable-PSBreakpoint。

输出

None or System.Management.Automation.Breakpoint

使用 PassThru 参数时， Enable-PSBreakpoint 返回一个断点对象，该断点对象表示已启用的断点。 否则，此 cmdlet 不会生成任何输出。

备注

  • Enable-PSBreakpoint如果尝试启用已启用的断点，则 cmdlet 不会生成错误。 因此，即使仅有少数断点处于禁用状态，你也可以启用所有断点而不发生错误。

  • 使用 cmdlet 创建断点时， Set-PSBreakpoint 会启用断点。 无需启用新创建的断点。