共用方式為

Disable-PSBreakpoint

  • 參考
模組:
Microsoft.PowerShell.Utility

在目前的主控台中停用中斷點。

Syntax

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

Description

Cmdlet 會 Disable-PSBreakpoint 停用斷點，以確保腳本執行時不會叫用這些斷點。 您可以使用它來停用所有中斷點，或是藉由送出中斷點物件或中斷點識別碼來指定中斷點。

就技術上來說，這個 Cmdlet 會將中斷點物件的 Enabled 屬性值變更為 False。 若要重新啟用斷點，請使用 Enable-PSBreakpoint Cmdlet。 當您使用 Set-PSBreakpoint Cmdlet 建立斷點時，預設會啟用斷點。

中斷點是指令碼中的暫時停止執行點，用來讓您檢查指令碼中的指示。 Disable-PSBreakpoint 是數個專為偵錯 PowerShell 腳本而設計的 Cmdlet 之一。 如需 PowerShell 調試程式的詳細資訊，請參閱 about_Debuggers。

範例

範例 1：設定斷點並加以停用

這些命令會停用新建的中斷點。

$B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
$B | Disable-PSBreakpoint

Cmdlet 會在Set-PSBreakpoint腳本中的$NameSample.ps1變數上建立斷點，並將斷點物件儲存在變數中$B。 Cmdlet 會 Disable-PSBreakpoint 停用新的斷點。 它會使用管線運算子 (|) 將斷點對象 $B 傳送至 Disable-PSBreakpoint Cmdlet。

由於此命令，中$B斷點物件的 Enabled 屬性值為 False。

範例 2：停用斷點

此命令停用具有中斷點識別碼 0 的中斷點。

Disable-PSBreakpoint -Id 0

範例 3：Create 停用的斷點

此命令建立新的中斷點，在您啟用之前它會是停用的。

Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)

它會使用 Disable-PSBreakpoint Cmdlet 來停用斷點。 Breakpoint 參數的值是一個Set-PSBreakpoint命令，可設定新的斷點、產生斷點物件，並將物件儲存在變數中$B。

以物件為其值的 Cmdlet 參數可接受包含物件的變數，或是取得或產生物件的命令。 在此情況下，因為 Set-PSBreakpoint 會產生斷點物件，所以可以當做 斷點 參數的值使用。

範例 4：停用目前控制台中的所有斷點

此命令停用目前主控台中的所有中斷點。

`Get-PSBreakpoint` | Disable-PSBreakpoint

範例 5：停用 Runspace 中的斷點

在此範例中，會啟動作業，並將中斷點設定為在執行 Set-PSBreakPoint 時中斷。 Runspace 會儲存在變數中，而且會使用 Runspace 參數傳遞至 Get-PSBreakPoint 命令。 的輸出 Get-PSBreakPoint 會透過管線傳送至 Disable-PSBreakpoint ，以停用 Runspace 中的斷點。

Start-Job -ScriptBlock {
    Set-PSBreakpoint -Command Start-Sleep
    Start-Sleep -Seconds 10
}

$runspace = Get-Runspace -Id 1

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

參數

-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

停用具有指定之中斷點識別碼的中斷點。 請輸入識別碼或包含識別碼的變數。 您無法使用管線將識別碼傳送至 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

-Runspace

指定 Runspace 物件的識別碼，讓您可以在指定的 Runspace 中與斷點互動。

此參數已新增至 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 包含的下列別名 Disable-PSBreakpoint：

  • 所有平台：
    • dbp