Get-PSBreakpoint

モジュール:

Microsoft.PowerShell.Utility

現在のセッションで設定されたブレークポイントを取得します。

構文

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

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

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

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

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

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

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

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

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

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

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

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"

パラメーター

-Command

指定したコマンド名に設定されているコマンド ブレークポイントの配列を指定します。 コマンドレットや関数の名前などのコマンド名を入力します。

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

このコマンドレットが取得するブレークポイント ID を指定します。 ID をコンマ区切りリスト形式で入力します。 ブレークポイント ID Get-PSBreakpointをパイプ処理することもできます。

Type:	Int32[]
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Script

ブレークポイントを含むスクリプトの配列を指定します。 パス (省略可能) と 1 つ以上のスクリプト ファイルの名前を入力します。 パスを省略した場合、現在のディレクトリが既定の場所になります。

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Type

このコマンドレットが取得するブレークポイントの種類の配列を指定します。 1 つまたは複数の型を入力します。 このパラメーターの有効値は、次のとおりです。

• 折れ線
• コマンド
• 変数

ブレークポイントの種類を次の値に Get-PSBreakPointパイプすることもできます。

Type:	BreakpointType[]
Accepted values:	Line, Variable, Command
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Variable

指定した変数名に設定されている変数ブレークポイントの配列を指定します。 ドル記号を付けずに変数名を入力します。

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

入力

Int32

BreakpointType

ブレークポイント ID とブレークポイントの種類をパイプ処理できます Get-PSBreakPoint。

出力

CommandBreakpoint

LineBreakpoint

VariableBreakpoint

Breakpoint

Get-PSBreakPoint は、セッション内のブレークポイントを表すオブジェクトを返します。

メモ

エイリアス "gbp" を使用 Get-PSBreakpoint できます。

関連リンク

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