Get-PSBreakpoint

構文

Get-PSBreakpoint
   [[-Script] <String[]>]
   [-Runspace <Runspace>]
   [<CommonParameters>]

Get-PSBreakpoint
   [[-Script] <String[]>]
   -Command <String[]>
   [-Runspace <Runspace>]
   [<CommonParameters>]

Get-PSBreakpoint
   [[-Script] <String[]>]
   -Variable <String[]>
   [-Runspace <Runspace>]
   [<CommonParameters>]

Get-PSBreakpoint
   [[-Script] <String[]>]
   [-Type] <BreakpointType[]>
   [-Runspace <Runspace>]
   [<CommonParameters>]

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

説明

Get-PSBreakPoint コマンドレットは、現在のセッションで設定されているブレークポイントを取得します。 コマンドレットのパラメーターを使用して、特定のブレークポイントを取得できます。

ブレークポイントとは、実行を一時的に停止して命令を調べることができるようにするための、コマンドまたはスクリプト内のポイントです。 Get-PSBreakpoint は、PowerShell スクリプトとコマンドのデバッグ用に設計されたいくつかのコマンドレットの 1 つです。 PowerShell デバッガーの詳細については、「 about_Debuggers」を参照してください。

例

例 1: すべてのスクリプトと関数のすべてのブレークポイントを取得する

このコマンドは、現在のセッション内のすべてのスクリプトおよび関数に設定されているすべてのブレークポイントを取得します。

Get-PSBreakpoint

例 2: ID でブレークポイントを取得する

このコマンドは、ブレークポイント ID が 2 のブレークポイントを取得します。

Get-PSBreakpoint -Id 2

Function         :
IncrementAction  :
Enabled          :
TrueHitCount     : 0
Id               : 2
Script           : C:\ps-test\sample.ps1
ScriptName       : C:\ps-test\sample.ps1

例 3: ID を "Get-PSBreakpoint" にパイプする

これらのコマンドは、ブレークポイント ID を Get-PSBreakpointにパイプしてブレークポイントを取得する方法を示しています。

$B = `Set-PSBreakpoint` -Script "sample.ps1" -Command "Increment"
$B.Id | Get-PSBreakpoint

Set-PSBreakpoint コマンドレットは、Sample.ps1 スクリプトの Increment 関数にブレークポイントを作成し、ブレークポイント オブジェクトを$B変数に保存します。 $B変数内のブレークポイント オブジェクトの Id プロパティは、ブレークポイント情報を表示するためにGet-PSBreakpoint コマンドレットにパイプされます。

例 4: 指定したスクリプト ファイル内のブレークポイントを取得する

このコマンドは、 Sample.ps1 および SupportScript.ps1 ファイル内のすべてのブレークポイントを取得します。

Get-PSBreakpoint -Script "Sample.ps1, SupportScript.ps1"

このコマンドは、他のスクリプトまたはセッション内の関数で設定される可能性のある他のブレークポイントを取得しません。

例 5: 指定したコマンドレットでブレークポイントを取得する

このコマンドは、Sample.ps1 ファイル内のコマンドRead-HostまたはWrite-Hostに設定されているすべてのコマンド ブレークポイントを取得します。

Get-PSBreakpoint -Command "Read-Host, Write-Host" -Script "Sample.ps1"

例 6: 指定したファイル内のコマンド ブレークポイントを取得する

Get-PSBreakpoint -Type Command -Script "Sample.ps1"

このコマンドは、Sample.ps1 ファイル内のすべてのコマンド ブレークポイントを取得します。

例 7: 変数でブレークポイントを取得する

このコマンドは、現在のセッションの $Index 変数と $Swap 変数に設定されているブレークポイントを取得します。

Get-PSBreakpoint -Variable "Index, Swap"

例 8: ファイル内のすべての行ブレークポイントと変数ブレークポイントを取得する

このコマンドは、 Sample.ps1 スクリプト内のすべての行ブレークポイントと変数ブレークポイントを取得します。

Get-PSBreakpoint -Type Line, Variable -Script "Sample.ps1"

例 9: 特定の実行空間に設定されたブレークポイントを取得する

この例では、ジョブが開始され、Set-PSBreakPoint の実行時に中断するようにブレークポイントが設定されます。 実行空間は変数に格納され、Runspace パラメーターを使用して Get-PSBreakPoint コマンドに渡されます。 その後、$breakpoint 変数内のブレークポイントを調べることができます。

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

$runspace = Get-Runspace -Id 1

$breakpoint = Get-PSBreakPoint -Runspace $runspace

パラメーター

-Command

-Id

-Runspace

-Script

-Type

-Variable

入力

Int32

ブレークポイント ID をこのコマンドレットにパイプできます。

BreakpointType

ブレークポイントの種類をこのコマンドレットにパイプできます。

出力

CommandBreakpoint

LineBreakpoint

VariableBreakpoint

Breakpoint

このコマンドレットは、セッション内のブレークポイントを表すオブジェクトを返します。

メモ

PowerShell には、 Get-PSBreakpointの次のエイリアスが含まれています。

• すべてのプラットフォーム:
  • gbp

関連リンク

• Disable-PSBreakpoint
• Enable-PSBreakpoint
• Get-PSCallStack
• Remove-PSBreakpoint
• Set-PSBreakpoint