次の方法で共有

Debug-Process

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

ローカル コンピューターで実行されている 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: コンピューター上のプロセスにデバッガーをアタッチする

Debug-Process -Name powershell

このコマンドは、コンピューター上の PowerShell プロセスにデバッガーをアタッチします。

例 2: 指定した文字列で始まるすべてのプロセスにデバッガーをアタッチする

Debug-Process -Name note*

このコマンドは、noteで始まる名前を持つすべてのプロセスにデバッガーをアタッチします。

例 3: デバッガーを複数のプロセスにアタッチする

Debug-Process "Winlogon", "Explorer", "Outlook"

このコマンドは、Winlogon、Explorer、および Outlook のプロセスにデバッガーをアタッチしようとします。 Winlogon は保護されたプロセスです。 Winlogon をデバッグするには、管理者としてコマンドを実行する必要があります。

例 4: デバッガーを複数のプロセス ID にアタッチする

Debug-Process -Id 1132, 2028

このコマンドは、プロセス ID 1132 と 2028 を持つプロセスにデバッガーをアタッチします。

例 5: Get-Process を使用してプロセスを取得し、デバッガーをアタッチする

Get-Process powershell | Debug-Process

このコマンドは、コンピューター上の PowerShell プロセスにデバッガーをアタッチします。 Get-Process コマンドレットを使用してコンピューター上の PowerShell プロセスを取得し、パイプライン 演算子 (|) を使用してプロセスを Debug-Process コマンドレットに送信します。

特定の PowerShell プロセスを指定するには、Get-Processの Id パラメーターを使用します。

例 6: ローカル コンピューター上の現在のプロセスにデバッガーをアタッチする

Debug-Process -Id $PID

このコマンドは、コンピューター上の現在の PowerShell プロセスにデバッガーをアタッチします。

このコマンドでは、$PID 自動変数が使用されます。この変数には、現在の PowerShell プロセスのプロセス ID が含まれています。 次に、パイプライン演算子 (|) を使用して、Debug-Process コマンドレットにプロセス ID を送信します。

$PID 自動変数の詳細については、about_Automatic_Variablesを参照してください。

例 7: 複数のコンピューターで指定したプロセスにデバッガーをアタッチする

Get-Process -ComputerName "Server01", "Server02" -Name "MyApp" | Debug-Process

このコマンドは、Server01 および Server02 コンピューター上の MyApp プロセスにデバッガーをアタッチします。

このコマンドでは、Get-Process コマンドレットを使用して、Server01 および Server02 コンピューター上の MyApp プロセスを取得します。 パイプライン 演算子を使用して、デバッガーをアタッチする Debug-Process コマンドレットにプロセスを送信します。

例 8: InputObject パラメーターを使用するプロセスにデバッガーをアタッチする

$P = Get-Process powershell
Debug-Process -InputObject $P

このコマンドは、ローカル コンピューター上の PowerShell プロセスにデバッガーをアタッチします。

最初のコマンドでは、Get-Process コマンドレットを使用して、コンピューター上の PowerShell プロセスを取得します。 結果のプロセス オブジェクトは、$Pという名前の変数に保存されます。

2 番目のコマンドでは、 コマンドレットの Debug-Process パラメーターを使用して、$P 変数にプロセス オブジェクトを送信します。

パラメーター

-Confirm

コマンドレットを実行する前に確認を求めるメッセージが表示されます。

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Id

デバッグするプロセスのプロセス ID を指定します。 パラメーター名 ID は省略可能です。

プロセスのプロセス ID を検索するには、「Get-Process」と入力します。

型:Int32[]
Aliases:PID, ProcessId
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-InputObject

デバッグするプロセスを表すプロセス オブジェクトを指定します。 プロセス オブジェクトを含む変数、またはプロセス オブジェクトを取得するコマンド (Get-Process コマンドレットなど) を入力します。 このコマンドレットにプロセス オブジェクトをパイプすることもできます。

型:Process[]
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Name

デバッグするプロセスの名前を指定します。 同じ名前のプロセスが複数ある場合、このコマンドレットは、その名前を持つすべてのプロセスにデバッガーをアタッチします。 Name パラメーターは省略可能です。

型:String[]
Aliases:ProcessName
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

Int32

このコマンドレットにプロセス ID をパイプできます。

Process

このコマンドレットには、プロセス オブジェクトをパイプ処理できます。

String

このコマンドレットにプロセス名をパイプできます。

出力

None

このコマンドレットは出力を返しません。

メモ

このコマンドレットでは、Windows Management Instrumentation (WMI) Win32_Process クラスの AttachDebugger メソッドを使用します。 このメソッドの詳細については、MSDN ライブラリ AttachDebugger メソッドの を参照してください。