共用方式為

Debug-Process

  • 參考
模組:
Microsoft.PowerShell.Management

對本機計算機上執行的一或多個進程進行偵錯。

語法

Debug-Process
     [-Name] <String[]>
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Debug-Process
     [-Id] <Int32[]>
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Debug-Process
     -InputObject <Process[]>
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

Cmdlet 會將 Debug-Process 調試程式附加至本機電腦上的一或多個執行中進程。 您可以依行程名稱或進程識別碼 （PID） 來指定進程，也可以使用管線將進程物件傳送至此 Cmdlet。

此 Cmdlet 會附加為進程註冊的調試程式。 使用此 Cmdlet 之前，請確認調試程式已安裝並設定。

範例

範例 1：將調試程式附加至電腦上的進程

Debug-Process -Name Powershell

此命令會將調試程式附加至電腦上的PowerShell進程。

範例 2：將調試程式附加至以指定字串開頭的所有進程

Debug-Process -Name note*

此命令會將調試程式附加至名稱開頭 note為 的所有進程。

範例 3：將調試程式附加至多個進程

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

此命令會嘗試將調試程式附加至 Winlogon、Explorer 和 Outlook 進程。 Winlogon 是受保護的程式。 若要偵錯 Winlogon，您必須以系統管理員身分執行命令。

範例 4：將調試程式附加至多個進程標識碼

Debug-Process -Id 1132, 2028

此命令會將調試程式附加至進程標識碼為 1132 和 2028 的進程。

範例 5：使用 Get-Process 取得進程，然後將調試程式附加至其中

Get-Process PowerShell | Debug-Process

此命令會將調試程式附加至電腦上的PowerShell進程。 它會使用 Get-Process Cmdlet 取得電腦上的 PowerShell 進程，並使用管線運算符 （|） 將行程傳送至 Debug-Process Cmdlet。

若要指定特定的 PowerShell 程式，請使用的 Get-ProcessID 參數。

範例 6：將調試程式附加至本機電腦上的目前進程

Debug-Process -Id $PID

此命令會將調試程式附加至電腦上的目前 PowerShell 進程。

此命令會 $PID 使用自動變數，其中包含目前 PowerShell 進程的進程識別碼。 然後，它會使用管線運算符 （|） 將進程標識碼傳送至 Debug-Process Cmdlet。

如需自動變數的詳細資訊 $PID ，請參閱 about_Automatic_Variables。

範例 7：將調試程式附加至多部電腦上的指定進程

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

此命令會將調試程式附加至 Server01 和 Server02 電腦上的 MyApp 進程。

此命令會 Get-Process 使用 Cmdlet 來取得 Server01 和 Server02 計算機上的 MyApp 進程。 它會使用管線運算符將進程傳送至 Debug-Process Cmdlet，以附加調試程式。

範例 8：將調試程式附加至使用 InputObject 參數的進程

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

此命令會將調試程式附加至本機電腦上的PowerShell進程。

第一個命令會 Get-Process 使用 Cmdlet 來取得電腦上的 PowerShell 進程。 它會將產生的進程物件儲存在名為 $P的變數中。

第二個命令會使用 Cmdlet 的 Debug-Process InputObject 參數，在變數中$P提交進程物件。

參數

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-Id

指定要偵錯之進程的進程標識碼。 Id 參數名稱是選擇性的。

若要尋找行程的程序識別碼，請輸入 Get-Process。

類型:Int32[]
別名:PID, ProcessId
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-InputObject

指定要偵錯之進程的進程物件。 輸入包含進程物件的變數，或取得進程物件的命令，例如 Get-Process Cmdlet。 您也可以使用管線將進程物件傳送至此 Cmdlet。

類型:Process[]
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-Name

指定要偵錯的進程名稱。 如果有多個具有相同名稱的進程，此 Cmdlet 會將調試程式附加至具有該名稱的所有進程。 Name 參數是選擇性的。

類型:String[]
別名:ProcessName
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

類型:SwitchParameter
別名:wi
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

Int32

您可以使用管線將進程標識碼傳送至此 Cmdlet。

Process

您可以使用管線將進程物件傳送至此 Cmdlet。

String

您可以使用管線將行程名稱傳送至此 Cmdlet。

輸出

None

此 Cmdlet 不會傳回任何輸出。

備註

此 Cmdlet 使用 Windows Management Instrumentation （WMI） Win32_Process 類別的 AttachDebugger 方法。 如需這個方法的詳細資訊，請參閱 MSDN 連結庫中的 AttachDebugger 方法 。