Debug-Process
ローカル コンピューター上で実行中の 1 つ以上のプロセスをデバッグします。
構文
Debug-Process
[-Name] <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Debug-Process
[-Id] <Int32[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Debug-Process
-InputObject <Process[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
コマンドレットは Debug-Process
、ローカル コンピューター上で実行中の 1 つ以上のプロセスにデバッガーをアタッチします。
プロセス名またはプロセス ID (PID) でプロセスを指定することも、プロセス オブジェクトをこのコマンドレットにパイプすることもできます。
このコマンドレットは、現在プロセスに登録されているデバッガーをアタッチします。 このコマンドレットを使用する前に、デバッガーがダウンロードされていて適切に設定されていることを確認します。
例
例 1: コンピューター上のプロセスにデバッガーをアタッチする
PS C:\> Debug-Process -Name "Windows Powershell"
このコマンドは、コンピューターの PowerShell プロセスにデバッガーを結合します。
例 2: 指定した文字列で始まるすべてのプロセスにデバッガーをアタッチする
PS C:\> Debug-Process -Name "SQL*"
このコマンドは、SQL で始まる名前を持つすべてのプロセスにデバッガーをアタッチします。
例 3: デバッガーを複数のプロセスにアタッチする
PS C:\> Debug-Process "Winlogon", "Explorer", "Outlook"
このコマンドは、Winlogon、Explorer、Outlook の各プロセスにデバッガーを結合します。
例 4: デバッガーを複数のプロセス ID にアタッチする
PS C:\> Debug-Process -Id 1132, 2028
このコマンドは、プロセス ID 1132 および 2028 のプロセスにデバッガーを結合します。
例 5: Get-Process を使用してプロセスを取得し、デバッガーをアタッチする
PS C:\> Get-Process "Windows PowerShell" | Debug-Process
このコマンドは、コンピューターの PowerShell プロセスにデバッガーを結合します。 コマンドレットを Get-Process
使用してコンピューター上の PowerShell プロセスを取得し、パイプライン演算子 (|
) を使用してコマンドレットにプロセスを Debug-Process
送信します。
特定の PowerShell プロセスを指定するには、 の Get-Process
ID パラメーターを使用します。
例 6: デバッガーをローカル コンピューターの現在のプロセスにアタッチする
PS C:\> $PID | Debug-Process
このコマンドは、コンピューターの現在の PowerShell プロセスにデバッガーを結合します。
コマンドは、現在の $PID
PowerShell プロセスのプロセス ID を含む自動変数を使用します。 次に、パイプライン演算子 (|
) を使用して、プロセス ID を コマンドレットに Debug-Process
送信します。
自動変数の $PID
詳細については、「 about_Automatic_Variables」を参照してください。
例 7: InputObject パラメーターを使用するプロセスにデバッガーをアタッチする
PS C:\> $P = Get-Process "Windows PowerShell"
PS C:\> Debug-Process -InputObject $P
このコマンドは、ローカル コンピューターの PowerShell プロセスにデバッガーを結合します。
最初のコマンドでは、 コマンドレットを Get-Process
使用して、コンピューター上の PowerShell プロセスを取得します。 結果のプロセス オブジェクトは、 という名前 $P
の変数に保存されます。
2 番目のコマンドでは、 コマンドレットの InputObject パラメーターを Debug-Process
使用して、 変数にプロセス オブジェクトを $P
送信します。
パラメーター
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
デバッグするプロセスのプロセス ID を指定します。 Id パラメーター名は省略可能です。
プロセスのプロセス ID を見つけるには、「」と入力します Get-Process
。
Type: | Int32[] |
Aliases: | PID, ProcessId |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InputObject
デバッグするプロセスを表すプロセス オブジェクトを指定します。 プロセス オブジェクトを含む変数、またはコマンドレットなどのプロセス オブジェクトを取得するコマンドを Get-Process
入力します。 このコマンドレットにプロセス オブジェクトをパイプすることもできます。
Type: | Process[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
デバッグするプロセスの名前を指定します。 同じ名前のプロセスが複数ある場合、このコマンドレットは、その名前を持つすべてのプロセスにデバッガーをアタッチします。 Name パラメーターは省略可能です。
Type: | String[] |
Aliases: | ProcessName |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
このコマンドレットにプロセス ID をパイプできます。
このコマンドレットにプロセス オブジェクトをパイプできます。
このコマンドレットにプロセス名をパイプできます。
出力
None
このコマンドレットは、出力を返しません。
メモ
このコマンドレットは、Windows Management Instrumentation (WMI) Win32_Process クラスの AttachDebugger メソッドを使用します。 このメソッドの詳細については、MSDN ライブラリの AttachDebugger メソッド に関するページを参照してください。