Debug-Process
除錯一個或多個在本地電腦上運行的程序。
語法
Name (預設值)
Debug-Process
[-Name] <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Id
Debug-Process
[-Id] <Int32[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InputObject
Debug-Process
-InputObject <Process[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
指令 Debug-Process 小程式將除錯器附加到本地電腦上一個或多個正在執行的程序上。
你可以用程序名稱或程序 ID（PID）來指定程序，或者將程序物件導向這個 cmdlet。
這個指令檔會附加已註冊的除錯器。 使用此 cmdlet 前，請確認已安裝並設定好除錯器。
範例
範例 1：將除錯器附加到電腦上的程序
Debug-Process -Name powershell
此指令將除錯器附加於電腦上的 PowerShell 程序。
範例 2：將所有以指定字串開頭的程序附加除錯器
Debug-Process -Name note*
此指令會為所有名稱以 為開頭 note的程序附加除錯器。
範例 3：將除錯器附加到多個程序
Debug-Process "Winlogon", "Explorer", "Outlook"
此指令嘗試將除錯器附加到 Winlogon、檔案總管和 Outlook 程序。 Winlogon 是一個受保護的程序。 要除錯 Winlogon，你必須以管理員身份執行該指令。
範例 4：將除錯器附加到多個程序 ID
Debug-Process -Id 1132, 2028
此指令會將除錯器附加到程序 ID 為 1132 與 2028 的程序。
範例 5：使用 Get-Process 取得一個程序，然後附加除錯器
Get-Process powershell | Debug-Process
此指令將除錯器附加到電腦上的 PowerShell 程序上。 它使用 Get-Process cmdlet 將 PowerShell 程序上傳到電腦，並使用管線運算子（|）將程序傳送到 Debug-Process cmdlet。
要指定特定的 PowerShell 程序，請使用 Id 參數。Get-Process
範例 6：將除錯器附加到本機電腦的當前程序
Debug-Process -Id $PID
此指令將除錯器附加到電腦上的現有 PowerShell 程序。
指令使用 $PID 自動變數，該變數包含目前 PowerShell 程序的程序 ID。 接著，它會使用管線運算子（|）將程序 ID 傳送給 Debug-Process cmdlet。
關於自動變數的更多資訊 $PID ，請參見 about_Automatic_Variables。
範例 7：將除錯器附加到使用 InputObject 參數的程序
$P = Get-Process powershell
Debug-Process -InputObject $P
此指令將除錯器附加到本地電腦上的 PowerShell 程序。
第一個指令使用 Get-Process cmdlet 來取得電腦上的 PowerShell 程序。 它會將產生的程序物件儲存在名為 $P的變數中。
第二個指令使用 cmdlet 的 Debug-ProcessInputObject 參數，將變數中的程序物件提交。$P
參數
-Confirm
在執行 Cmdlet 之前，提示您進行確認。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 參見 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Id
指定待除錯程序的程序 ID。 Id 參數名稱是可選的。
要找到程序的程序 ID，請輸入 Get-Process。
參數屬性
| 類型: | Int32[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | PID, ProcessId |
參數集
Id
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-InputObject
指定代表待除錯程序的程序物件。 輸入包含程序物件的變數，或輸入取得程序物件的指令，例如 Get-Process cmdlet。 你也可以將 process 物件串接到這個 cmdlet。
參數屬性
| 類型: | Process[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
InputObject
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Name
指定待除錯程序的名稱。 如果有多個同名的程序，這個 cmdlet 會為所有該名稱的程序附加除錯器。 名稱參數是可選的。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | ProcessName |
參數集
Name
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。 指令未執行。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 威斯康辛 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸入
Int32
你可以將程序 ID 管道傳送到這個 cmdlet。
Process
你可以把一個程序物件輸入這個 cmdlet。
String
你可以將程序名稱輸入這個 cmdlet。
輸出
None
此 Cmdlet 不會傳回任何輸出。
備註
此指令小程式使用 Windows 管理儀器（WMI）Win32_Process 類別的 AttachDebugger 方法。 欲了解更多此方法資訊，請參閱 MSDN 函式庫中的 AttachDebugger 方法 。
