Partager via

Debug-Process

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

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

Syntaxe

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 inscrit pour le processus. Avant d’utiliser cette applet de commande, vérifiez qu’un débogueur est installé et configuré.

Exemples

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

Debug-Process -Name 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

Debug-Process -Name note*

Cette commande attache un débogueur à tous les processus qui ont des noms qui commencent par note.

Exemple 3 : Attacher un débogueur à plusieurs processus

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

Cette commande tente d’attacher un débogueur aux processus Winlogon, Explorer et Outlook. Winlogon est un processus protégé. Pour déboguer Winlogon, vous devez exécuter la commande en tant qu’administrateur.

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

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

Get-Process 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

Debug-Process -Id $PID

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 au processus spécifié sur plusieurs ordinateurs

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

Cette commande joint un débogueur aux processus MyApp sur les ordinateurs Server01 et Server02.

La commande utilise l’applet Get-Process de commande pour obtenir les processus MyApp sur les ordinateurs Server01 et Server02. Il utilise un opérateur de pipeline pour envoyer les processus à l’applet Debug-Process de commande, qui attache les débogueurs.

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

$P = Get-Process PowerShell
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
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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[]
Alias:PID, ProcessId
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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[]
Alias:ProcessName
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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.