Enable-PSBreakpoint

模組:
Microsoft.PowerShell.Utility Module

啟用目前主控台的中斷點。

語法

Breakpoint (預設值) 

Enable-PSBreakpoint
    [-Breakpoint] <Breakpoint[]>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Id 

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

Description

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.ps1Name 變數建立斷點，並將中斷點物件儲存在變$B數中。 PassThru 參數顯示斷點 Enabled 屬性的值為 False。

Enable-PSBreakpoint 重新啟用中斷點。 同樣地，利用 PassThru 參數，我們看到 Enabled 屬性的值為 True。

範例 4：使用變數啟用斷點

此範例使用斷點物件使得一組斷點成為可能。

$B = Get-PSBreakpoint -Id 3, 5
Enable-PSBreakpoint -Breakpoint $B

Get-PSBreakpoint 取得斷點並儲存在變數中 $B 。 利用 Breakpoint 參數，啟用 Enable-PSBreakpoint 這些斷點。

此範例等價於運行 Enable-PSBreakpoint -Id 3, 5。

範例 5：在跑道空間中啟用斷點

在這個例子中，一個工作以中斷點開始，設定為中斷點後被停用。 Runspace 會儲存在變數中，並使用 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。

參數屬性

類型:

Breakpoint[]

預設值:None
支援萬用字元:False
不要顯示:False

參數集

Breakpoint
Position:0
必要:True
來自管線的值:True
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Confirm

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

參數屬性

類型:SwitchParameter
預設值:False
支援萬用字元:False
不要顯示:False
別名:參見

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Id

指定要啟用的斷點的 Id 編號。 預設值是所有斷點。 請以數字或變數提供 識別 碼。 你無法將 ID 數字輸入 Enable-PSBreakpoint。 要找到斷點的 ID ，請使用 Get-PSBreakpoint cmdlet。

參數屬性

類型:

Int32[]

預設值:None
支援萬用字元:False
不要顯示:False

參數集

Id
Position:0
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-PassThru

回傳一個代表被啟用斷點的物件。 根據預設，此 Cmdlet 不會產生任何輸出。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Runspace

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

此參數已在PowerShell 7.2中新增。

參數屬性

類型:Runspace
預設值:None
支援萬用字元:False
不要顯示:False
別名:RunspaceID

參數集

Id
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 該 Cmdlet 未被執行。

參數屬性

類型:SwitchParameter
預設值:False
支援萬用字元:False
不要顯示:False
別名:威斯康辛

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。

輸入

Breakpoint

你可以把斷點物件管線到這個 cmdlet。

輸出

None

根據預設，此 Cmdlet 不會傳回任何輸出。

Breakpoint

當你使用 PassThru 參數時，這個 cmdlet 會回傳一個代表啟用斷點的斷點物件。

備註

PowerShell 包含下列 Enable-PSBreakpoint的別名：

  • 所有平臺：

    • ebp

  • Enable-PSBreakpoint如果你嘗試啟用已經啟用的斷點，指令長子不會產生錯誤。 因此，即使只有少數斷點被禁用，也能無錯誤地啟用所有斷點。

  • 斷點是在你用 Set-PSBreakpoint cmdlet 建立它們時才會啟用的。 你不需要啟用新建立的斷點。