Debug-Process
Odstraňuje chyby v jednom nebo více procesech spuštěných na místním počítači.
Syntaxe
Name (Výchozí)
Debug-Process
[-Name] <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Id
Debug-Process
[-Id] <Int32[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InputObject
Debug-Process
-InputObject <Process[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Cmdlet Debug-Process připojí ladicí program k jednomu nebo více spuštěným procesům na místním počítači.
Procesy můžete zadat podle názvu procesu nebo ID procesu (PID) nebo můžete řadit objekty procesu do této rutiny.
Tato cmdlet připojí ladicí program, který je zaregistrovaný pro tento proces. Před použitím tohoto cmdletu ověřte, že je nainstalovaný a nakonfigurovaný ladicí program.
Příklady
Příklad 1: Připojte ladicí program k procesu v počítači
Debug-Process -Name powershell
Tento příkaz připojí ladicí program k procesu PowerShellu v počítači.
Příklad 2: Připojení ladicího programu ke všem procesům, které začínají zadaným řetězcem
Debug-Process -Name note*
Tento příkaz připojí ladicí program ke všem procesům, které mají názvy začínající note.
Příklad 3: Připojení ladicího programu k více procesům
Debug-Process "Winlogon", "Explorer", "Outlook"
Tento příkaz se pokusí připojit ladicí program k procesům Winlogon, Exploreru a Outlooku. Winlogon je chráněný proces. Pokud chcete ladit Winlogon, musíte příkaz spustit jako správce.
Příklad 4: Připojení ladicího programu k více ID procesů
Debug-Process -Id 1132, 2028
Tento příkaz připojí ladicí program k procesům, které mají ID procesů 1132 a 2028.
Příklad 5: Použití Get-Process k získání procesu a připojení ladicího programu k němu
Get-Process powershell | Debug-Process
Tento příkaz připojí ladicí program k procesům PowerShellu v počítači. Pomocí rutiny Get-Process získá procesy PowerShellu v počítači a pomocí operátoru kanálu (|) odešle procesy do rutiny Debug-Process.
Pokud chcete zadat konkrétní proces PowerShellu, použijte parametr id Get-Process.
Příklad 6: Připojení ladicího programu k aktuálnímu procesu na místním počítači
Debug-Process -Id $PID
Tento příkaz připojí ladicí program k aktuálním procesům PowerShellu v počítači.
Příkaz používá $PID automatickou proměnnou, která obsahuje ID procesu aktuálního procesu PowerShellu. Poté pomocí operátoru roury (|) předá ID procesu rutině Debug-Process.
Další informace o automatické proměnné $PID najdete v části , která pojednává o about_Automatic_Variables.
Příklad 7: Připojení ladicího programu k procesu, který používá parametr InputObject
$P = Get-Process powershell
Debug-Process -InputObject $P
Tento příkaz připojí ladicí program k procesům PowerShellu v místním počítači.
První příkaz používá rutinu Get-Process k získání procesů PowerShellu v počítači. Uloží výsledný objekt procesu do proměnné s názvem $P.
Druhý příkaz používá parametr InputObject rutiny Debug-Process k odeslání objektu procesu do proměnné $P.
Parametry
-Confirm
Před spuštěním cmdletu vás vyzve k potvrzení.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | viz |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Id
Určuje ID procesů, které je třeba ladit. Název parametru ID je volitelný.
Chcete-li zjistit ID procesu, zadejte Get-Process.
Vlastnosti parametru
| Typ: | Int32[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | identifikátor PID, Id procesu |
Sady parametrů
Id
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-InputObject
Určuje objekty procesu, které představují procesy, které se mají ladit. Zadejte proměnnou obsahující objekty procesu nebo příkaz, který získá objekty procesu, například rutinu Get-Process. Do tohoto příkazu můžete také přesměrovat objekty procesu.
Vlastnosti parametru
| Typ: | Process[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
InputObject
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Name
Určuje názvy procesů, které se mají debuggovat. Pokud existuje více procesů se stejným názvem, připojí tato rutina ladicí program ke všem procesům s tímto názvem. Parametr Name je volitelný.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | ProcessName |
Sady parametrů
Name
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-WhatIf
Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Wi |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
Int32
ID procesu můžete do tohoto cmdletu předat.
Process
Objekt procesu můžete do této cmdletu přesměrovat.
String
Název procesu můžete předat tomuto cmdletu.
Výstupy
None
Tento cmdlet nevrátí žádný výstup.
Poznámky
Tato rutina používá metodu AttachDebugger třídy Win32_Process windows Management Instrumentation (WMI). Další informace o této metodě najdete v tématu Metoda AttachDebugger v Microsoft Learn.
