Debug-Process

  • Référence
Module:
Microsoft.PowerShell.Management

Débogue un ou plusieurs processus en cours d'exécution sur l'ordinateur local.

Syntax

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

Description

L’applet Debug-Process de commande attache un débogueur à un ou plusieurs processus en cours d’exécution sur un ordinateur local. Vous pouvez spécifier les processus par leur nom de processus ou leur ID de processus (PID), ou vous pouvez diriger les objets de processus vers cette applet de commande.

Cette applet de commande joint le débogueur actuellement inscrit pour le processus. Avant d'utiliser cette applet de commande, vérifiez qu'un débogueur est téléchargé et correctement configuré.

Exemples

Exemple 1 : Attacher un débogueur à un processus sur l’ordinateur

PS C:\> Debug-Process -Name "Windows Powershell"

Cette commande joint un débogueur au processus PowerShell sur l'ordinateur.

Exemple 2 : Attacher un débogueur à tous les processus commençant par la chaîne spécifiée

PS C:\> Debug-Process -Name "SQL*"

Cette commande attache un débogueur à tous les processus qui ont des noms commençant par SQL.

Exemple 3 : Attacher un débogueur à plusieurs processus

PS C:\> Debug-Process "Winlogon", "Explorer", "Outlook"

Cette commande joint un débogueur aux processus Winlogon, Explorer et Outlook.

Exemple 4 : Attacher un débogueur à plusieurs ID de processus

PS C:\> Debug-Process -Id 1132, 2028

Cette commande joint un débogueur aux processus dont les identificateurs sont 1132 et 2028.

Exemple 5 : Utiliser Get-Process pour obtenir un processus, puis attacher un débogueur à celui-ci

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

Cette commande joint un débogueur aux processus PowerShell sur l'ordinateur. Il utilise l’applet Get-Process de commande pour obtenir les processus PowerShell sur l’ordinateur et utilise un opérateur de pipeline (|) pour envoyer les processus à l’applet Debug-Process de commande.

Pour spécifier un processus PowerShell particulier, utilisez le paramètre ID de Get-Process.

Exemple 6 : Attacher un débogueur à un processus actuel sur l’ordinateur local

PS C:\> $PID | Debug-Process

Cette commande joint un débogueur aux processus PowerShell actifs sur l'ordinateur.

La commande utilise la $PID variable automatique, qui contient l’ID de processus du processus PowerShell actuel. Ensuite, il utilise un opérateur de pipeline (|) pour envoyer l’ID de processus à l’applet Debug-Process de commande.

Pour plus d’informations sur la $PID variable automatique, consultez about_Automatic_Variables.

Exemple 7 : Attacher un débogueur à un processus qui utilise le paramètre InputObject

PS C:\> $P = Get-Process "Windows PowerShell"
PS C:\> Debug-Process -InputObject $P

Cette commande joint un débogueur aux processus PowerShell sur l'ordinateur local.

La première commande utilise l’applet Get-Process de commande pour obtenir les processus PowerShell sur l’ordinateur. Il enregistre l’objet de processus résultant dans la variable nommée $P.

La deuxième commande utilise le paramètre InputObject de l’applet Debug-Process de commande pour envoyer l’objet de processus dans la $P variable.

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

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

-Id

Spécifie l'identificateur des processus à déboguer. Le nom du paramètre ID est facultatif.

Pour rechercher l’ID de processus d’un processus, tapez Get-Process.

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

-InputObject

Spécifie les objets processus qui représentent les processus à déboguer. Entrez une variable qui contient les objets de processus ou une commande qui obtient les objets de processus, comme l’applet Get-Process de commande. Vous pouvez également diriger les objets de traitement vers cette applet de commande.

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

-Name

Spécifie le nom des processus à déboguer. S’il existe plusieurs processus portant le même nom, cette applet de commande attache un débogueur à tous les processus portant ce nom. Le paramètre Name est facultatif.

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

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

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

Entrées

Int32

Vous pouvez diriger un ID de processus vers cette applet de commande.

Process

Vous pouvez diriger un objet de processus vers cette applet de commande.

String

Vous pouvez diriger un nom de processus vers cette applet de commande.

Sorties

None

Cette applet de commande ne retourne pas de sortie.

Notes

Cette applet de commande utilise la méthode AttachDebugger de la classe WMI (Windows Management Instrumentation) Win32_Process. Pour plus d’informations sur cette méthode, consultez la méthode AttachDebugger dans la bibliothèque MSDN.