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
Rutina Debug-Process připojí ladicí program k jednomu nebo několika 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 Windows 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 Windows PowerShellu v počítači. Pomocí rutiny Get-Process získá procesy Windows 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 Windows PowerShellu v počítači.
Příkaz používá $PID automatickou proměnnou, která obsahuje ID procesu aktuálního procesu Windows PowerShellu. Potom pomocí operátoru kanálu (|) odešle ID procesu do rutiny Debug-Process.
Další informace o $PID automatické proměnné najdete v tématu about_Automatic_Variables.
Příklad 7: Připojení ladicího programu k zadanému procesu na více počítačích
PS C:\> Get-Process -ComputerName "Server01", "Server02" -Name "MyApp" | Debug-Process
Tento příkaz připojí ladicí program k procesům MyApp na počítačích Se serverem 01 a Server02.
Příkaz používá rutinu Get-Process k získání procesů MyApp na počítačích Se serverem 01 a Server02. Používá operátor kanálu k odeslání procesů do rutiny Debug-Process, která připojí ladicí programy.
Příklad 8: 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 Windows PowerShellu v místním počítači.
První příkaz používá rutinu Get-Process k získání procesů Windows PowerShellu na 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.