Debug-Runspace

Debug-Runspace
    [-Runspace] <Runspace>
    [-BreakAll]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Debug-Runspace
    [-Name] <String>
    [-BreakAll]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Debug-Runspace
    [-Id] <Int32>
    [-BreakAll]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Debug-Runspace
    [-InstanceId] <Guid>
    [-BreakAll]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

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

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

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

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

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

[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:\> >

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 で実行空間を識別します。 スクリプトにはブレークポイントがあるため、デバッガーが開きます。

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

Get-Runspace コマンドの結果をこのコマンドレットにパイプできます。

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

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