Enable-PSBreakpoint
启用当前控制台中的断点。
语法
Enable-PSBreakpoint
[-PassThru]
[-Breakpoint] <Breakpoint[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Enable-PSBreakpoint
[-PassThru]
[-Id] <Int32[]>
[-Runspace <Runspace>]
[-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.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
。 使用 断点 参数启用 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 |
输入
可以通过管道将断点对象传递给此 cmdlet。
输出
None
默认情况下,此 cmdlet 不返回任何输出。
使用 PassThru 参数时,此 cmdlet 返回表示启用的断点的断点对象。
备注
PowerShell 包含以下别名 Enable-PSBreakpoint
:
所有平台:
ebp
如果尝试启用已启用的断点,则
Enable-PSBreakpoint
cmdlet 不会生成错误。 因此,即使仅有少数断点处于禁用状态,你也可以启用所有断点而不发生错误。使用
Set-PSBreakpoint
cmdlet 创建断点时,会启用断点。 无需启用新创建的断点。