Debug-Process
Débogue un ou plusieurs processus s’exécutant sur l’ordinateur local.
Syntaxe
Name (Par défaut)
Debug-Process
[-Name] <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Id
Debug-Process
[-Id] <Int32[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InputObject
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 cmdlet attache le débogueur enregistré 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 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
Debug-Process -Name note*
Cette commande attache un débogueur à tous les processus qui ont des noms commençant 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 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
Get-Process 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
Debug-Process -Id $PID
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
$P = Get-Process powershell
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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | Int32[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Identifiant de processus (PID), ProcessId |
Jeux de paramètres
Id
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | Process[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
InputObject
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | ProcessName |
Jeux de paramètres
Name
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-WhatIf
Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
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 Microsoft Learn.
