Partager via

Debug-Process

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

Débogue un ou plusieurs processus s’exécutant 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 de commande Debug-Process 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 attache 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 attache 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 attache un débogueur aux processus qui ont des ID de processus 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 attache un débogueur aux processus PowerShell sur l’ordinateur. Il utilise l’applet de commande Get-Process pour obtenir les processus PowerShell sur l’ordinateur et utilise un opérateur de pipeline (|) pour envoyer les processus à l’applet de commande Debug-Process.

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 attache un débogueur aux processus PowerShell actuels sur l’ordinateur.

La commande utilise la variable automatique $PID, 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 de commande Debug-Process.

Pour plus d’informations sur la variable automatique $PID, 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 attache un débogueur aux processus PowerShell sur l’ordinateur local.

La première commande utilise l’applet de commande Get-Process 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 de commande Debug-Process pour envoyer l’objet de processus dans la variable $P.

Paramètres

-Confirm

Vous invite à confirmer 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 les ID de processus 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 de 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, tels que l’applet de commande Get-Process. 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 les noms 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

Affiche ce qui se passerait si l’applet de commande s’exécute. 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 aucune 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 méthode AttachDebugger dans msdn library.