Enter-PSHostProcess

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

ローカル プロセスに接続して対話型セッションに入ります。

構文

Enter-PSHostProcess
     [-Id] <Int32>
     [[-AppDomainName] <String>]
     [<CommonParameters>]
Enter-PSHostProcess
     [-Process] <Process>
     [[-AppDomainName] <String>]
     [<CommonParameters>]
Enter-PSHostProcess
     [-Name] <String>
     [[-AppDomainName] <String>]
     [<CommonParameters>]
Enter-PSHostProcess
     [-HostProcessInfo] <PSHostProcessInfo>
     [[-AppDomainName] <String>]
     [<CommonParameters>]

説明

コマンドレットは Enter-PSHostProcess 、ローカル プロセスに接続して対話型セッションに入ります。

PowerShell をホストしてリモート セッションを実行する新しいプロセスを作成する代わりに、リモートの対話型セッションは、既に PowerShell を実行している既存のプロセスで実行されます。 指定したプロセスでリモート セッションと対話する場合は、実行中の実行空間を列挙し、デバッグする実行空間を選択できます。次に、実行するか Debug-Runspace 、または Enable-RunspaceDebug実行します。

入力するプロセスは、PowerShell (System.Management.Automation.dll) をホストしている必要があります。 プロセスが見つかったコンピューター上の 管理istrators グループのメンバーであるか、プロセスを開始したスクリプトを実行しているユーザーである必要があります。

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

デバッグ セッションからデタッチし、プロセスとの対話型セッションを終了 2 回実行するか、既存のデバッガー終了コマンドを実行してスクリプトの実行を停止します。

Name パラメーターを使用してプロセスを指定し、指定した名前のプロセスが 1 つだけ見つかった場合は、プロセスが入力されます。 指定した名前の複数のプロセスが見つかった場合、PowerShell はエラーを返し、指定した名前で検出されたすべてのプロセスを一覧表示します。

リモート コンピューター上のプロセスへのアタッチをサポートするために、 Enter-PSHostProcess コマンドレットは指定されたリモート コンピューターで有効になっているため、リモート PowerShell セッション内でローカル プロセスにアタッチできます。

例

パート 1 の例: PowerShell I Standard Edition プロセス内で実行空間のデバッグを開始する

この例では、PowerShell コンソール内から実行Enter-PSHostProcessして、PowerShell I Standard Edition プロセスに入ります。 結果の対話型セッションでは、実行して Get-Runspaceデバッグする実行空間を見つけ、実行空間をデバッグできます。

PS C:\> Enter-PSHostProcess -Name powershell_ise
[Process:1520]: PS C:\>  Get-Runspace
Id    Name          InstanceId                               State           Availability
--    -------       -----------                              ------          -------------
1     Runspace1     2d91211d-9cce-42f0-ab0e-71ac258b32b5     Opened          Available
2     Runspace2     a3855043-cb16-424a-a616-685360c3763b     Opened          RemoteDebug
3     MyLocalRS     2236dbd8-2105-4dec-a15a-a27d0bfaacb5     Opened          LocalDebug
4     MyRunspace    771356e9-8c44-4b70-9de5-dd17cb41e48e     Opened          Busy
5     Runspace8     3e517382-a97a-49ba-9c3c-fd21f6664288     Broken          None

パート 2 の例: 特定の実行空間をデバッグする

次に、別のユーザーの実行時間の長いスクリプトを実行している実行空間 ID 4 をデバッグします。 から返された一覧から Get-Runspace、実行空間 の状態 が開かれていることに注意してください 。可用性 はビジーです。つまり、実行空間は実行時間の長いスクリプトを実行しています。 また、返されるGet-Runspace実行スペース オブジェクトには、実行中のコマンド スタックの ScriptStackTrace という NoteProperty があります (使用可能な場合)。

[Process:1520]: PS C:\>  (Get-Runspace -Id 4).ScriptStackTrace
Command                    Arguments                           Location
-------                    ---------                           --------
MyModuleWorkflowF1         {}                                  TestNoFile3.psm1: line 6
WFTest1                    {}                                  TestNoFile2.ps1: line 14
TestNoFile2.ps1            {}                                  TestNoFile2.ps1: line 22
<ScriptBlock>              {}                                  <No file>

[Process: 1520]: PS C:\>  Debug-Runspace -Id 4
Hit Line breakpoint on 'C:\TestWFVar1.ps1:83'

At C:\TestWFVar1.ps1:83 char:1
+ $scriptVar = "Script Variable"
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

[Process: 1520]: [RSDBG: 4]: PS C:\>

コマンドレットを実行して、この実行空間で対話型デバッグ セッションを Debug-Runspace 開始します。

パート 3 の例: デバッグ セッションを終了して終了する

デバッグが完了したら、終了デバッガー コマンドを実行して、デバッガーをアタッチせずにスクリプトの実行を続行できるようにします。 または、q または Stop コマンドを使用してデバッガーを終了することもできます。

プロセスの作業が完了したら、コマンドレットを実行してプロセスを Exit-PSHostProcess 終了します。 これにより、プロンプトに PS C:\> 戻ります。

[Process:346]: [RSDBG: 3]: PS C:\> exit
[Process:1520]: PS C:\>
[Process:1520]: PS C:\>  Exit-PSHostProcess
PS C:\>

パラメーター

-AppDomainName

省略した場合に接続するアプリケーションの doメイン 名を指定し、DefaultAppDoメイン を使用します。 アプリケーションの doメイン 名を表示するために使用Get-PSHostProcessInfoします。

Type:String
Position:1
Default value:DefaultAppDomain
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HostProcessInfo

PowerShell で 接続できる PSHostProcessInfo オブジェクトを指定します。 オブジェクトを取得するために使用 Get-PSHostProcessInfo します。

Type:PSHostProcessInfo
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Id

プロセス ID でプロセスを指定します。 プロセス ID を取得するには、コマンドレットを実行します Get-Process 。

Type:Int32
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

プロセス名でプロセスを指定します。 プロセス名を取得するには、コマンドレットを Get-Process 実行します。 タスク マネージャーのプロセスの [プロパティ] ダイアログ ボックスからプロセス名を取得することもできます。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Process

プロセス オブジェクトによるプロセスを指定します。 このパラメーターを使用する最も簡単な方法は、変数に入力するプロセスを返すコマンドの Get-Process 結果を保存し、このパラメーターの値として変数を指定することです。

Type:Process
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

入力

Process

メモ

Enter-PSHostProcess では、コマンドを実行している PowerShell セッションのプロセスを入力できません。 ただし、別の PowerShell セッションのプロセス、または実行中のセッションと同時に実行されている PowerShell I Standard Edition セッションEnter-PSHostProcessを入力できます。

Enter-PSHostProcess は、PowerShell をホストしているプロセスのみを入力できます。 つまり、PowerShell エンジンが読み込まれました。

プロセス内からプロセスを終了するには、「exit」と入力し、Enter キーを押します。