Debug-Process

  • Reference
Modul:
Microsoft.PowerShell.Management

Ladí jeden nebo více procesů spuštěných v místním počítači.

Syntax

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

Description

Rutina Debug-Process připojí ladicí program k jednomu nebo více spuštěným procesům v 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řipojení ladicího programu 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: Získání procesu pomocí příkazu Get-Process a pak k němu připojte ladicí program.

PS C:\> Get-Process "Windows PowerShell" | Debug-Process

Tento příkaz připojí ladicí program k procesům PowerShellu v počítači. Používá rutinu Get-Process k získání procesů PowerShellu v počítači a k odeslání procesů do Debug-Process rutiny používá operátor kanálu (|).

Pokud chcete zadat konkrétní proces PowerShellu, použijte parametr ID parametru 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á automatickou proměnnou $PID , která obsahuje ID procesu aktuálního procesu 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 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 pomocí rutiny Get-Process získá procesy PowerShellu v počítači. Uloží výsledný objekt procesu do proměnné s názvem $P.

Druhý příkaz používá parametr Debug-Process InputObject rutiny k odeslání objektu $P procesu v proměnné.

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Určuje ID procesů, které se mají ladit. Název parametru ID je volitelný.

Chcete-li zjistit ID procesu, zadejte Get-Process.

Type:Int32[]
Aliases:PID, ProcessId
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-InputObject

Určuje objekty procesu, které představují procesy, které se mají ladit. Zadejte proměnnou, která obsahuje objekty procesu, nebo příkaz, který získá objekty procesu, například rutinu Get-Process . Do této rutiny můžete také pipetovat objekty zpracování.

Type:Process[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Určuje názvy procesů, které se mají ladit. 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ý.

Type:String[]
Aliases:ProcessName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

Int32

ID procesu můžete do této rutiny převést.

Process

Objekt procesu můžete do této rutiny převést.

String

Název procesu můžete do této rutiny převést.

Výstupy

None

Tato rutina 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ě naleznete v tématu AttachDebugger metoda v knihovně MSDN.