Debug-Process
Ladí jeden nebo více procesů spuštěných v místním počítači.
Syntax
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 rutina připojí ladicí program, který je aktuálně zaregistrovaný pro tento proces. Před použitím této rutiny ověřte, jestli je ladicí program stažený a správně nakonfigurovaný.
Příklady
Příklad 1: Připojte ladicí program k procesu v počítači
PS C:\> Debug-Process -Name "Windows 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
PS C:\> Debug-Process -Name "SQL*"
Tento příkaz připojí ladicí program ke všem procesům, které mají názvy začínající sql.
Příklad 3: Připojení ladicího programu k více procesům
PS C:\> Debug-Process "Winlogon", "Explorer", "Outlook"
Tento příkaz připojí ladicí program k procesům Winlogon, Exploreru a Outlooku.
Příklad 4: Připojení ladicího programu k více ID procesů
PS C:\> 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
PS C:\> Get-Process "Windows 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
PS C:\> $PID | Debug-Process
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
PS C:\> $P = Get-Process "Windows PowerShell"
PS C:\> 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
System.Int32, System.Diagnostics.Process, System.String
Id procesu (Int32), objekt procesu (System.Diagnostics.Process) nebo název procesu (String) můžete do této rutiny převést.
Výstupy
None
Tato rutina negeneruje žádný výstup.
Poznámky
Tento cmdlet používá metodu AttachDebugger třídy Win32_Process Windows Management Instrumentation (WMI). Další informace o této metodě naleznete v tématu AttachDebugger metoda v knihovně MSDN.