Windows PowerShell デバッグ環境では、変数ブレークポイント、コマンド ブレークポイント、および行ブレークポイントという 3 種類のブレークポイントを設定できます。Windows PowerShell ISE デバッグ環境で、これらのブレークポイントのうち行ブレークポイントのみは、強調表示してメニューまたはキーボード ショートカットを使用して設定することができます。他の 2 種類のブレークポイントも設定できますが、コマンド ペインで Set-PSBreakpoint コマンドレットを使用する必要があります。すべてのブレークポイントは、削除、有効化、無効化、および一覧表示することができます。このセクションでは、利用可能な場合はメニューを使用して Windows PowerShell ISE でデバッグ タスクを実行する方法、およびスクリプトを使用してコマンド ペインでより広範囲にわたるコマンドを実行する方法について説明します。

ブレークポイントを管理する

ブレークポイントの設定

Windows PowerShell スクリプトまたは関数に行ブレークポイントを設定します。ブレークポイントは、スクリプトを保存した後にのみ設定できます。

ブレークポイントを設定する行を右クリックし、[ブレークポイントの設定/解除] をクリックします。または、ブレークポイントを設定する行をクリックし、[デバッグ] メニューの [ブレークポイントの設定/解除] をクリックします。次のスクリプトは、コマンド ペインから Set-PSBreakpoint コマンドレットを使用して変数ブレークポイントを設定する例です。

# This command sets a breakpoint on the Server variable in the Sample.ps1 script.
set-psbreakpoint -script sample.ps1 -variable Server 

すべてのブレークポイントの一覧を表示

現在のセッションのブレークポイントをすべて表示します。

[デバッグ] メニューの [ブレークポイントの一覧を表示] をクリックします。次のスクリプトは、コマンド ペインから Get-PSBreakpoint コマンドレットを使用してすべてのブレークポイントを一覧表示する例です。

 # This command lists all breakpoints in the current session. 
get-psbreakpoint 

ブレークポイントの削除

特定の行ブレークポイントを削除します。

ブレークポイントを削除する行を右クリックし、[ブレークポイントの設定/解除] をクリックします。または、ブレークポイントを削除する行をクリックし、[デバッグ] メニューの [ブレークポイントの設定/解除] をクリックします。次のスクリプトは、コマンド ペインから Remove-PSBreakpoint コマンドレットを使用して指定した ID のブレークポイントを削除する例です。

# This command deletes the breakpoint with breakpoint ID 2.
remove-psbreakpoint -id 2

すべてのブレークポイントを削除

現在のセッションからすべてのブレークポイントを削除します。

[デバッグ] メニューの [すべてのブレークポイントを削除] をクリックします。次のスクリプトは、コマンド ペインから Remove-PSBreakpoint コマンドレットを使用してすべてのブレークポイントを削除する例です。

# This command deletes all of the breakpoints in the current session.
get-breakpoint | remove-breakpoint


ブレークポイントの無効化

特定の行ブレークポイントを無効化します。

ブレークポイントを無効化する行を右クリックし、[ブレークポイントの無効化] をクリックします。または、ブレークポイントを無効化する行をクリックし、[デバッグ] メニューの [ブレークポイントの無効化] をクリックします。次のスクリプトは、コマンド ペインから Disable-PSBreakpoint コマンドレットを使用して指定した ID のブレークポイントを削除する例です。

# This command disables the breakpoint with breakpoint ID 0.
disable-psbreakpoint -id 0


すべてのブレークポイントの無効化

現在のセッションのブレークポイントをすべて無効化します。

[デバッグ] メニューの [すべてのブレークポイントの無効化] をクリックします。次のスクリプトは、コマンド ペインから Disable-PSBreakpoint コマンドレットを使用してすべてのブレークポイントを無効化する例です。

# This command disables all breakpoints in the current console. 
# You can abbreviate this command as: "gbp | dbp".

get-psbreakpoint | disable-psbreakpoint




ブレークポイントの有効化

特定の行ブレークポイントを有効化します。

ブレークポイントを有効化する行を右クリックし、[ブレークポイントの有効化] をクリックします。または、ブレークポイントを有効化する行をクリックし、F8 キーを押すか、[デバッグ] メニューの [ブレークポイントの有効化] をクリックします。次のスクリプトは、コマンド ペインから Enable-PSBreakpoint コマンドレットを使用して特定のブレークポイントを有効化する例です。

# This command enables breakpoints with breakpoint IDs 0, 1, and 5.
enable-psbreakpoint -id 0, 1, 5




すべてのブレークポイントの有効化

現在のセッションのブレークポイントをすべて有効化します。

[デバッグ] メニューの [すべてのブレークポイントの有効化] をクリックします。次のスクリプトは、コマンド ペインから Enable-PSBreakpoint コマンドレットを使用してすべてのブレークポイントを有効化する例です。

# This command enables all breakpoints in the current session. 
# You can abbreviate the command as "gbp | ebp".


get-psbreakpoint | enable-psbreakpoint

関連項目




目次