共用方式為

Disable-PSBreakpoint

  • 參考
模組:
Microsoft.PowerShell.Utility

停用目前控制台中的斷點。

語法

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

Description

Disable-PSBreakpoint Cmdlet 會停用斷點，這可確保腳本執行時不會叫用斷點。 您可以使用它來停用所有斷點，也可以藉由提交斷點對象或斷點標識碼來指定斷點。

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

斷點是腳本中的一個點，執行會暫時停止，讓您可以檢查腳本中的指示。 Disable-PSBreakpoint 是數個專為偵錯 PowerShell 腳本而設計的 Cmdlet 之一。 如需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

此命令會停用斷點標識碼為 0 的斷點。

範例 3：建立停用的斷點

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。

類型:Breakpoint[]
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-Id

使用指定的斷點標識碼停用斷點。 輸入標識碼或包含標識碼的變數。 您無法使用管線將識別碼傳送至 disable-PSBreakpoint。

類型: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

您可以使用管線將斷點物件傳送至 disable-PSBreakpoint。

輸出

None or System.Management.Automation.Breakpoint

當您使用 PassThru 參數時，Disable-PSBreakpoint 會傳回代表停用斷點的物件。 否則，此 Cmdlet 不會產生任何輸出。