取得目前工作階段中所設定的中斷點。

語法

Get-PSBreakpoint [[-Script] <string[]>] [<CommonParameters>]

Get-PSBreakpoint -Command <string[]> [-Script <string[]>] [<CommonParameters>]

Get-PSBreakpoint [-Id] <Int32[]> [<CommonParameters>]

Get-PSBreakpoint [-Type] <BreakpointType[]> [-Script <string[]>] [<CommonParameters>]

Get-PSBreakpoint -Variable <string[]> [-Script <string[]>] [<CommonParameters>]

描述

Get-PSBreakPoint Cmdlet 會取得目前工作階段中所設定的中斷點。您可以使用 Cmdlet 參數取得特定的中斷點。

中斷點是命令或指令碼中的一個位置,只要指令碼執行到此處就會暫停執行,讓您可以檢查指令碼中的指令。Get-PSBreakpoint 是其中幾個專為偵錯 Windows PowerShell 指令碼或命令所設計的 Cmdlet。如需 Windows PowerShell 偵錯工具的詳細資訊,請參閱 about_Debuggers。

參數

-Command <string[]>

取得指定的命令名稱上所設定的命令中斷點。請輸入命令名稱,例如 Cmdlet 或函數的名稱。

必要?

true

位置?

named

預設值

All breakpoints

接受管線輸入?

false

接受萬用字元?

false

-Id <Int32[]>

取得有指定的中斷點識別碼的中斷點。請以逗號分隔的清單輸入識別碼。您也可經由管道將中斷點識別碼輸出至 Get-PSBreakpoint。

必要?

true

位置?

1

預設值

All breakpoints

接受管線輸入?

true (ByValue)

接受萬用字元?

false

-Script <string[]>

只取得指定的指令碼中的中斷點。請輸入一個或多個指令碼檔的路徑 (選擇性) 和名稱。預設位置為目前目錄。

必要?

false

位置?

named

預設值

All breakpoints

接受管線輸入?

false

接受萬用字元?

false

-Type <BreakpointType[]>

只取得指定的型別的中斷點。請輸入一個或多個型別。有效的值為 Line、Command 和 Variable。您也可經由管道將中斷點型別輸出至 Get-PSBreakpoint。

必要?

true

位置?

1

預設值

All breakpoints

接受管線輸入?

true (ByValue)

接受萬用字元?

false

-Variable <string[]>

取得指定的變數名稱上所設定的變數中斷點。請輸入變數名稱,但不要加上貨幣符號。

必要?

true

位置?

named

預設值

All breakpoints

接受管線輸入?

false

接受萬用字元?

false

<CommonParameters>

這個 Cmdlet 支援一般參數:-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊,請參閱 about_Commonparameters.

輸入和輸出

輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。

輸入

System.Int32、Microsoft.PowerShell.Commands.BreakpointType

您可經由管道將中斷點識別碼和中斷點型別輸出至 Get-PSBreakpoint。

輸出

中斷點物件 (System.Management.Automation.LineBreakpoint、System.Management.Automation.VariableBreakpoint、System.Management.Automation.CommandBreakpoint)

Get-PSBreakPoint 會傳回代表工作階段內中斷點的物件。

附註

您可以使用 Get-PSBreakpoint 或其別名 "gbp"。

範例 1

C:\PS>get-psbreakpoint

描述
-----------
這個命令會取得目前工作階段中所有指令碼和函數上所設定的所有中斷點。






範例 2

C:\PS>get-psbreakpoint -Id 2

Function   : Increment
Action     :
Enabled    : True
HitCount   : 0
Id         : 2
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

描述
-----------
這個命令會取得中斷點識別碼為 2 的中斷點。






範例 3

C:\PS>$b = set-psbreakpoint -script sample.ps1 -function increment

C:\PS> $b.Id | get-psbreakpoint

描述
-----------
這些命令示範如何經由管道將中斷點識別碼輸出至 Get-PSBreakpoint 來取得中斷點。

第一個命令會使用 Set-PSBreakpoint Cmdlet 在 Sample.ps1 指令碼的 Increment 函數上建立中斷點,然後將中斷點物件儲存到 $b 變數。

第二個命令會以點運算子 (.) 來取得 $b 變數中的中斷點物件的 Id 屬性,並使用管線運算子 (|) 將識別碼傳送給 Get-PSBreakpoint Cmdlet。

因此,Get-PSBreakpoint 便會取得有指定的識別碼的中斷點。






範例 4

C:\PS>get-psbreakpoint -script Sample.ps1, SupportScript.ps1

描述
-----------
這個命令會取得 Sample.ps1 和 SupportScript.ps1 檔案中的所有中斷點。

這個命令不會取得工作階段中其他指令碼或函數上可能設定的其他中斷點。






範例 5

C:\PS>get-psbreakpoint -command Read-Host, Write-Host -script Sample.ps1

描述
-----------
這個命令會取得 Sample.ps1 檔案中 Read-Host 或 Write-Host 命令上所設定的所有命令中斷點。






範例 6

C:\PS>get-psbreakpoint -type Command -script Sample.ps1

描述
-----------
這個命令會取得 Sample.ps1 檔案中的所有命令中斷點。






範例 7

C:\PS>get-psbreakpoint -variable Index, Swap

描述
-----------
這個命令會取得目前工作階段中 $index 和 $swap 變數上所設定的中斷點。






範例 8

C:\PS>get-psbreakpoint -type line, variable -script Sample.ps1

描述
-----------
這個命令會取得 Sample.ps1 指令碼中的所有行中斷點和變數中斷點。






請參閱




目錄