Disable-PSBreakpoint

参考

模块:: Microsoft.PowerShell.Utility

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

语法

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

输入

Breakpoint

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

输出

None or System.Management.Automation.Breakpoint

使用 PassThru 参数时， Disable-PSBreakpoint 将返回表示禁用的断点的对象。否则，此 cmdlet 将不生成任何输出。

通过