Set-PSBreakpoint

Set-PSBreakpoint -Command <string[]> [[-Script] <string[]>] [-Action <scriptblock>] [<CommonParameters>]

Set-PSBreakpoint [-Script] <string[]> [-Line] <Int32[]> [[-Column] <int>] [-Action <scriptblock>] [<CommonParameters>]

Set-PSBreakpoint -変数 <string[]> [[-Script] <string[]>] [-Mode {<Read> | <Write> | <ReadWrite>}] [-Action <scriptblock>] [<CommonParameters>]

C:\PS>set-psbreakpoint -script sample.ps1 -line 5

Column     : 0
Line       : 5
Action     :
Enabled    : True
HitCount   : 0
Id         : 0
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

説明
-----------
このコマンドは、Sample.ps1 スクリプト内の行 5 にブレークポイントを設定します。結果として、スクリプトを実行すると、行 5 が実行される直前に実行が停止されます。

行番号によって新しいブレークポイントを設定すると、Set-PSBreakpoint コマンドレットは、次のサンプル出力に示されているようにブレークポイント ID およびヒット カウントが含まれる行ブレークポイント オブジェクト (System.Management.Automation.LineBreakpoint) を生成します。

C:\PS>set-psbreakpoint -command Increment -script sample.ps1

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

説明
-----------
このコマンドは、Sample.ps1 コマンドレットの Increment 関数にコマンド ブレークポイントを作成します。スクリプトは、指定された関数を呼び出す直前に実行を停止します。

この結果がコマンド ブレークポイント オブジェクトになります。スクリプトの実行前、HitCount プロパティの値は 0 です。

C:\PS>set-psbreakpoint -script sample.ps1 -variable Server -Mode ReadWrite

説明
-----------
このコマンドは、Sample.ps1 スクリプト内の Server 変数にブレークポイントを設定します。ReadWrite 値と共に Mode パラメーターを使用して、変数値が読み取られたときや変数値が変更される直前に実行を停止します。

C:\PS>set-psbreakpoint -script Sample.ps1 -command "write*"

説明
-----------
このコマンドは、"write-host" などの "write" で始まる Sample.ps1 スクリプト内のすべてのコマンドにブレークポイントを設定します。

C:\PS>set-psbreakpoint -script test.ps1 -command DiskTest `
  -action { (if $disk -gt 2) { break } }

説明
-----------
このコマンドは、$disk 変数の値が 2 よりも大きい場合にのみ、Test.ps1 スクリプト内の DiskTest 関数で実行を停止します。

このコマンドは、Set-PSBreakpoint コマンドレットを使用して DiskTest 関数にコマンド ブレークポイントを設定します。アクションの値は、関数で $disk 変数の値をテストするスクリプト ブロックになります。

このアクションでは、条件が満たされたときに Break キーワードを使用して実行が停止されます。代わりに使用できるのは (および既定値は) CONTINUE です。

C:\PS>set-psbreakpoint -command checkpoint-computer

Id       : 0
Command  : checkpoint-computer
Enabled  : True
HitCount : 0
Action   :

C:\PS> function CheckLog {
>> get-eventlog -log Application | 
>> where {($_.source -like "TestApp") -and ($_.Message -like "*failed*")}
>>}
>>
C:\PS> Checklog
DEBUG: Hit breakpoint(s)
DEBUG:  Function breakpoint on 'prompt:Checklog'
C:\PS>>>

説明
-----------
このコマンドは、CheckLog 関数にブレークポイントを設定します。このコマンドはスクリプトを指定しないため、現在のセッションで実行されているものにブレークポイントが設定されます。デバッガーは、関数の宣言時ではなく呼び出し時に割り込みます。

C:\PS>set-psbreakpoint -script sample.ps1 -line 1, 14, 19 -column 2 -action {&(log.ps1)}

Column     : 2
Line       : 1
Action     :
Enabled    : True
HitCount   : 0
Id         : 6
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

Column     : 2
Line       : 14
Action     :
Enabled    : True
HitCount   : 0
Id         : 7
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

Column     : 2
Line       : 19
Action     :
Enabled    : True
HitCount   : 0
Id         : 8
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

説明
-----------
このコマンドは、Sample.ps1 スクリプトに 3 つの行ブレークポイントを設定します。スクリプトで指定された各行で、列 2 に 1 つのブレークポイントを設定します。Action パラメーターで指定されたアクションは、すべてのブレークポイントに適用されます。