Disable-PSBreakpoint
禁用当前控制台中的断点。
语法
Disable-PSBreakpoint
[-PassThru]
[-Breakpoint] <Breakpoint[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Disable-PSBreakpoint
[-PassThru]
[-Id] <Int32[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
Disable-PSBreakpoint cmdlet 禁用断点,这可确保在脚本运行时不会命中断点。 可使用它来禁用所有断点,或者可通过提交断点对象或断点 ID 来指定断点。
在技术上,该 cmdlet 将断点对象的 Enabled 属性值更改为 False。 若要重新启用断点,请使用 Enable-PSBreakpoint cmdlet。 当使用 Set-PSBreakpoint cmdlet 来创建断点时,将默认启用断点。
断点是脚本中的一个点,将在其中暂时停止执行脚本,从而使你可以检查脚本中的指令。 Disable-PSBreakpoint 是用于调试Windows PowerShell脚本的几个 cmdlet 之一。 有关 Windows PowerShell 调试程序的详细信息,请参阅 about_Debuggers。
示例
示例 1:设置断点并禁用它
PS C:\> $B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
PS C:\> $B | Disable-PSBreakpoint
这些命令禁用新创建的断点。
第一个命令使用 Set-PSBreakpoint cmdlet 在 Sample.ps1 脚本中的 Name 变量上创建断点。 然后,它将断点对象保存在 $B 变量中。
第二个命令使用 Disable-PSBreakpoint cmdlet 来禁用新的断点。 它使用管道运算符 (|) 将 $B 中的断点对象发送到 Disable-PSBreakpoint cmdlet。
由于此命令,$B中断点对象的 Enabled 属性的值为 False。
示例 2:禁用断点
PS C:\> Disable-PSBreakpoint -Id 0
此命令禁用断点 ID 为 0 的断点。
示例 3:Create禁用的断点
PS C:\> Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)
PS C:\> $B
此命令创建新断点,在你启用该断点之前,该断点将一直禁用。
它使用 Disable-PSBreakpoint cmdlet 禁用断点。 断点参数的值是一个 Set-PSBreakpoint 命令,用于设置新的断点、生成断点对象并将对象保存在$B变量中。
Cmdlet 参数将对象用作值,可接受包含对象的变量或者可获取或生成对象的命令。 在这种情况下,由于 Set-PSBreakpoint 生成断点对象,因此它可用作 断点 参数的值。
第二个命令在 $B 变量的值中显示断点对象。
示例 4:禁用当前控制台中的所有断点
PS C:\> Get-PSBreakpoint | Disable-PSBreakpoint
此命令禁用当前控制台中的所有断点。 可将此命令缩写为:“gbp | dbp”。
参数
-Breakpoint
指定要禁用的断点。 输入一个包含断点对象的变量,或可获取断点对象的命令(如 Get-PSBreakpoint 命令)。 还可以通过管道将断点对象传递给 Disable-PSBreakpoint cmdlet。
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 传递给 Disable-PSBreakpoint。
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 |
输入
可以通过管道将断点对象传递给 Disable-PSBreakpoint。
输出
None or System.Management.Automation.Breakpoint
使用 PassThru 参数时, Disable-PSBreakpoint 将返回表示禁用的断点的 对象。 否则,此 cmdlet 将不生成任何输出。