Debug-Runspace

Debug-Runspace コマンドレットは、ローカルまたはリモートのアクティブな実行空間で対話型デバッグ セッションを開始します。 デバッグする実行空間を見つけるには、最初に Get-Process を実行して PowerShell に関連付けられているプロセスを検索し Enter-PSHostProcess 、 次に Id パラメーターで指定されたプロセス ID を使用してプロセスにアタッチし、PowerShell ホスト プロセス内の実行空間を一覧表示 Get-Runspace 。

デバッグする実行空間を選択した後、実行空間が現在コマンドまたはスクリプトを実行している場合、またはスクリプトがブレークポイントで停止している場合、PowerShell は実行空間のリモート デバッガー セッションを開きます。 実行空間スクリプトは、リモート セッション スクリプトをデバッグするのと同じ方法でデバッグできます。

PowerShell ホスト プロセスにアタッチできるのは、プロセスを実行しているコンピューターの管理者である場合、またはデバッグするスクリプトを実行している場合のみです。 また、現在の PowerShell セッションを実行しているホスト プロセスに入ることはできません。 別の PowerShell セッションを実行しているホスト プロセスのみを入力できます。

PS C:\> Get-Process -ComputerName "WS10TestServer" -Name "*powershell*"

Handles      WS(K)   VM(M)      CPU(s)    Id  ProcessName
-------      -----   -----      ------    --  -----------
    377      69912     63     2.09      2420  powershell
    399     123396    829     4.48      1152  powershell_ise

PS C:\> Enter-PSSession -ComputerName "WS10TestServer"
[WS10TestServer]:PS C:\> Enter-PSHostProcess -Id 1152
[WS10TestServer:][Process:1152]: PS C:\Users\Test\Documents> Get-Runspace

Id Name            ComputerName    Type          State         Availability
-- ----            ------------    ----          -----         ------------
 1 Runspace1       WS10TestServer  Remote        Opened        Available
 2 RemoteHost      WS10TestServer  Remote        Opened        Busy

PS C:\> [WS10TestServer][Process:1152]: PS C:\Users\Test\Documents> Debug-Runspace -Id 2

Hit Line breakpoint on 'C:\TestWFVar1.ps1:83'
At C:\TestWFVar1.ps1:83 char:1
+ $scriptVar = "Script Variable"
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
[Process:1152]: [RSDBG: 2]: PS C:\> >

この例では、リモート コンピューター WS10TestServer で開いている実行空間をデバッグします。 コマンドの最初の行では、リモート コンピューターで Get-Process を実行し、Windows PowerShell ホスト プロセスをフィルター処理します。 この例では、プロセス ID 1152 (Windows PowerShell ISE ホスト プロセス) をデバッグします。

2 番目のコマンドでは、 Enter-PSSession を実行して WS10TestServer でリモート セッションを開きます。 3 番目のコマンドでは、 Enter-PSHostProcess を実行し、最初のコマンド 1152 で取得したホスト プロセスの ID を指定して、リモート サーバーで実行されている Windows PowerShell ISE ホスト プロセスに接続します。

4 番目のコマンドでは、 Get-Runspace を実行して、プロセス ID 1152 の使用可能な実行空間を一覧表示します。 ビジー状態の実行空間の ID 番号をメモします。デバッグするスクリプトを実行しています。

最後のコマンドでは、スクリプト TestWFVar1.ps1を実行している開いている実行空間のデバッグを開始するには、 Debug-Runspace を実行し、 Id パラメータを追加して ID 2 で実行空間を識別します。 スクリプトにはブレークポイントがあるため、デバッガーが開きます。

Runspace

Get-Runspace コマンドの結果を Debug-Runspace にパイプ処理できます。

Debug-Runspace は、Opened 状態のランスペースで動作します。 実行空間の状態が [オープン] から別の状態に変わると、その実行空間は実行リストから自動的に削除されます。 実行空間は、次の条件を満たす場合にのみ、実行リストに追加されます。

• それがInvoke-Commandから来ている場合。つまり、 Invoke-Command GUID ID があります。
• Debug-Runspace から来ている場合、つまり、Debug-Runspace GUID ID があります。
• PowerShell ワークフローから送信され、そのワークフロー ジョブ ID が現在アクティブなデバッガー ワークフロー ジョブ ID と同じである場合。