次の方法で共有

Get-PSBreakpoint

  • リファレンス
モジュール:
Microsoft.PowerShell.Utility

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

構文

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

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

型:String[]
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Id

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

型:Int32[]
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Runspace

指定した実行空間内のブレークポイントと対話できるように、Runspace オブジェクトの ID を指定します。

このパラメーターは PowerShell 7.2 で追加されました。

型:Runspace
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Script

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

型:String[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Type

このコマンドレットが取得するブレークポイントの種類の配列を指定します。 1 つ以上の型を入力します。 このパラメーターに使用できる値は次のとおりです。

  • 線
  • 命令
  • 変数

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

型:BreakpointType[]
指定可能な値:Line, Variable, Command
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Variable

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

型:String[]
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

Int32

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

BreakpointType

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

出力

CommandBreakpoint

LineBreakpoint

VariableBreakpoint

Breakpoint

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

メモ

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

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