Enable-PSBreakpoint

  • 参考
模块:
Microsoft.PowerShell.Utility

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

语法

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

说明

Enable-PSBreakpoint cmdlet 重新启用已禁用的断点。 可以使用它启用所有断点，或者通过提供断点对象或断点 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 cmdlet 在 Sample.ps1 脚本中的 Name 变量上创建断点，并将断点对象保存在 $B 变量中。 PassThru 参数显示断点的 Enabled 属性的值为 False。

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

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

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

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

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

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

示例 5：在运行空间中启用断点

在此示例中，将会启动一个作业，并且设置了一个断点以便中断，然后该断点被禁用。 运行空间存储在变量中，并通过“运行空间”参数传递到 Get-PSBreakPoint 命令。 Get-PSBreakPoint 的输出通过管道传递给 Enable-PSBreakpoint 以在运行空间中启用该断点。

Start-Job -ScriptBlock {
    $bp = Set-PSBreakpoint -Command Start-Sleep
    Disable-PSBreakpoint $bp
    Start-Sleep -Seconds 10
}

$runspace = Get-Runspace -Id 1

Get-PSBreakPoint -Runspace $runspace | Enable-Breakpoint -Runspace $runspace

参数

-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

-Runspace

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

此参数已在 PowerShell 7.2 中添加。

Type:Runspace
Aliases:RunspaceId
Position:Named
Default value:None
Required:False
Accept pipeline input:True
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

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

输出

None

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

Breakpoint

使用 PassThru 参数时，此 cmdlet 将返回一个表示已启用断点的断点对象。

备注

PowerShell 包含 Enable-PSBreakpoint 的以下别名：

  • 所有平台：

    • ebp

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

  • 当使用 Set-PSBreakpoint cmdlet 创建断点时，断点将处于启用状态。 你不需要启用新创建的断点。