Delen via

Debug-Process

  • Referentie
Module:
Microsoft.PowerShell.Management

Fouten opsporen in een of meer processen die worden uitgevoerd op de lokale computer.

Syntaxis

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

Description

De Debug-Process cmdlet koppelt een foutopsporingsprogramma aan een of meer actieve processen op een lokale computer. U kunt de processen opgeven op basis van hun procesnaam of proces-id (PID), of u kunt procesobjecten doorsluisen naar deze cmdlet.

Met deze cmdlet wordt het foutopsporingsprogramma gekoppeld dat is geregistreerd voor het proces. Controleer voordat u deze cmdlet gebruikt of er een foutopsporingsprogramma is geïnstalleerd en geconfigureerd.

Voorbeelden

Voorbeeld 1: Een foutopsporingsprogramma koppelen aan een proces op de computer

Debug-Process -Name Powershell

Met deze opdracht wordt een foutopsporingsprogramma gekoppeld aan het PowerShell-proces op de computer.

Voorbeeld 2: Een foutopsporingsprogramma koppelen aan alle processen die beginnen met de opgegeven tekenreeks

Debug-Process -Name note*

Met deze opdracht wordt een foutopsporingsprogramma gekoppeld aan alle processen met namen die beginnen met note.

Voorbeeld 3: Een foutopsporingsprogramma koppelen aan meerdere processen

Debug-Process "Winlogon", "Explorer", "Outlook"

Met deze opdracht wordt geprobeerd een foutopsporingsprogramma toe te voegen aan de Winlogon-, Explorer- en Outlook-processen. Winlogon is een beveiligd proces. Als u fouten wilt opsporen in Winlogon, moet u de opdracht uitvoeren als beheerder.

Voorbeeld 4: Een foutopsporingsprogramma koppelen aan meerdere proces-id's

Debug-Process -Id 1132, 2028

Met deze opdracht wordt een foutopsporingsprogramma gekoppeld aan de processen met proces-id's 1132 en 2028.

Voorbeeld 5: Gebruik Get-Process om een proces op te halen en voeg er vervolgens een foutopsporingsprogramma aan toe

Get-Process PowerShell | Debug-Process

Met deze opdracht wordt een foutopsporingsprogramma gekoppeld aan de PowerShell-processen op de computer. De cmdlet Get-Process wordt gebruikt om de PowerShell-processen op de computer op te halen en er wordt een pijplijnoperator (|) gebruikt om de processen naar de Debug-Process-cmdlet te verzenden.

Als u een bepaald PowerShell-proces wilt opgeven, gebruikt u de id-parameter van Get-Process.

Voorbeeld 6: Een foutopsporingsprogramma koppelen aan een huidig proces op de lokale computer

Debug-Process -Id $PID

Met deze opdracht wordt een foutopsporingsprogramma gekoppeld aan de huidige PowerShell-processen op de computer.

De opdracht maakt gebruik van de $PID automatische variabele, die de proces-id van het huidige PowerShell-proces bevat. Vervolgens wordt een pijplijnoperator (|) gebruikt om de proces-id naar de Debug-Process-cmdlet te verzenden.

Zie about_Automatic_Variablesvoor meer informatie over de automatische variabele $PID.

Voorbeeld 7: Een foutopsporingsprogramma koppelen aan het opgegeven proces op meerdere computers

Get-Process -ComputerName "Server01", "Server02" -Name "MyApp" | Debug-Process

Met deze opdracht wordt een foutopsporingsprogramma gekoppeld aan de MyApp-processen op de Server01- en Server02-computers.

De opdracht maakt gebruik van de Get-Process cmdlet om de MyApp-processen op de Server01- en Server02-computers op te halen. Er wordt een pijplijnoperator gebruikt om de processen te verzenden naar de cmdlet Debug-Process, waarmee de foutopsporingsprogramma's worden gekoppeld.

Voorbeeld 8: Een foutopsporingsprogramma koppelen aan een proces dat gebruikmaakt van de parameter InputObject

$P = Get-Process PowerShell
Debug-Process -InputObject $P

Met deze opdracht wordt een foutopsporingsprogramma gekoppeld aan de PowerShell-processen op de lokale computer.

De eerste opdracht maakt gebruik van de Get-Process cmdlet om de PowerShell-processen op de computer op te halen. Het resulterende procesobject wordt opgeslagen in de variabele met de naam $P.

De tweede opdracht maakt gebruik van de parameter InputObject van de Debug-Process-cmdlet om het procesobject in te dienen in de variabele $P.

Parameters

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Id

Hiermee geeft u de proces-id's van de processen die moeten worden opgespoord. De -id parameternaam is optioneel.

Als u de proces-id van een proces wilt zoeken, typt u Get-Process.

Type:Int32[]
Aliassen:PID, ProcessId
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-InputObject

Hiermee geeft u de procesobjecten op die processen vertegenwoordigen die moeten worden opgespoord. Voer een variabele in die de procesobjecten of een opdracht bevat waarmee de procesobjecten worden opgehaald, zoals de cmdlet Get-Process. U kunt ook procesobjecten doorsluisen naar deze cmdlet.

Type:Process[]
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

Hiermee geeft u de namen op van de processen die moeten worden opgespoord. Als er meer dan één proces met dezelfde naam is, koppelt deze cmdlet een foutopsporingsprogramma aan alle processen met die naam. De parameter Name is optioneel.

Type:String[]
Aliassen:ProcessName
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

Int32

U kunt een proces-id doorsluisen naar deze cmdlet.

Process

U kunt een procesobject doorsluisen naar deze cmdlet.

String

U kunt een procesnaam doorsluisen naar deze cmdlet.

Uitvoerwaarden

None

Deze cmdlet retourneert geen uitvoer.

Notities

Deze cmdlet maakt gebruik van de AttachDebugger-methode van de WMI-Win32_Process klasse (Windows Management Instrumentation). Zie AttachDebugger-methode in de MSDN-bibliotheek voor meer informatie over deze methode.