Enable-PSBreakpoint

参考

模块:: Microsoft.PowerShell.Utility

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

语法

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

Enable-PSBreakpoint
      [-PassThru]
      [-Breakpoint] <Breakpoint[]>
      [-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。

参数

-Breakpoint

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

类型:	Breakpoint[]
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Confirm

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

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-Id

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

类型:	Int32[]
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-PassThru

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

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

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

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

输入

Breakpoint

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

输出

None

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