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 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 Windows 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 Windows PowerShell sur l’ordinateur. Il utilise l’applet de commande Get-Process pour obtenir les processus Windows 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 Windows PowerShell actuels sur l’ordinateur.
La commande utilise la variable automatique $PID, qui contient l’ID de processus du processus Windows 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 au processus spécifié sur plusieurs ordinateurs
PS C:\> Get-Process -ComputerName "Server01", "Server02" -Name "MyApp" | Debug-Process
Cette commande attache un débogueur aux processus MyApp sur les ordinateurs Server01 et Server02.
La commande utilise l’applet de commande Get-Process pour obtenir les processus MyApp sur les ordinateurs Server01 et Server02. Il utilise un opérateur de pipeline pour envoyer les processus à l’applet de commande Debug-Process, qui attache les débogueurs.
Exemple 8 : 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 Windows PowerShell sur l’ordinateur local.
La première commande utilise l’applet de commande Get-Process
La deuxième commande utilise le paramètre
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
System.Int32, System.Diagnostics.Process, System.String
Vous pouvez diriger un ID de processus (Int32), un objet de processus (System.Diagnostics.Process) ou un nom de processus (String) vers cette applet de commande.
Sorties
None
Cette applet de commande ne génère 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.