Débogue un ou plusieurs processus en cours d'exécution sur l'ordinateur local.
Syntaxe
Debug-Process [-Name] <string[]> [-Confirm] [-WhatIf] [<CommonParameters>] Debug-Process [-Id] <Int32[]> [-Confirm] [-WhatIf] [<CommonParameters>] Debug-Process -InputObject <Process[]> [-Confirm] [-WhatIf] [<CommonParameters>]
Description
L'applet de commande Debug-Process joint un débogueur à un ou plusieurs processus en cours d'exécution sur un ordinateur local. Vous pouvez spécifier les processus en indiquant leur nom ou leur identificateur ou vous pouvez diriger des objets processus vers Debug-Process.
Debug-Process joint le débogueur qui est actuellement enregistré pour le processus. Avant d'utiliser cette applet de commande, vérifiez qu'un débogueur est téléchargé et correctement configuré.
Paramètres
-Id <Int32[]>
Spécifie l'identificateur des processus à déboguer. Le nom de paramètre (« -Id ») est facultatif.
Pour rechercher l'identificateur d'un processus, tapez « get-process ».
|
Obligatoire ? |
true |
|
Position ? |
1 |
|
Valeur par défaut |
aucun |
|
Accepter l'entrée de pipeline ? |
true (ByPropertyName) |
|
Accepter les caractères génériques ? |
false |
-InputObject <Process[]>
Spécifie les objets processus qui représentent les processus à déboguer. Entrez une variable qui contient les objets processus ou une commande qui obtient les objets processus (commande Get-Process, par exemple). Vous pouvez également diriger les objets processus vers Debug-Process.
|
Obligatoire ? |
true |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
true (ByValue) |
|
Accepter les caractères génériques ? |
false |
-Name <string[]>
Spécifie le nom des processus à déboguer. Si plusieurs processus portent le même nom, Debug-Process joint un débogueur à tous les processus qui portent ce nom. Le nom de paramètre (« Name ») est facultatif.
|
Obligatoire ? |
true |
|
Position ? |
1 |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
true (ByPropertyName) |
|
Accepter les caractères génériques ? |
false |
-Confirm
Vous invite à confirmer l'exécution de la commande.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-WhatIf
Décrit le résultat que vous obtiendriez en exécutant la commande, sans réellement l'exécuter.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.
Entrées et sorties
Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.
|
Entrées |
System.Int32, System.Diagnostics.Process, System.String Vous pouvez diriger un identificateur de processus (Int32), un objet processus (System.Diagnostics.Process) ou un nom de processus (String) vers Debug-Process. |
|
Sorties |
None Cette applet de commande ne génère aucune sortie. |
Remarques
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 » (page éventuellement en anglais) dans MSDN Library, à l'adresse https://go.microsoft.com/fwlink/?LinkId=143640.
Exemple 1
C:\PS>debug-process -name powershell Description ----------- Cette commande joint un débogueur au processus PowerShell sur l'ordinateur.
Exemple 2
C:\PS>debug-process -name sql* Description ----------- Cette commande joint un débogueur à tous les processus dont le nom commence par « sql ».
Exemple 3
C:\PS>debug-process winlogon, explorer, outlook Description ----------- Cette commande joint un débogueur aux processus Winlogon, Explorer et Outlook.
Exemple 4
C:\PS>debug-process -id 1132, 2028 Description ----------- Cette commande joint un débogueur aux processus dont l'identificateur est 1132 et 2028.
Exemple 5
C:\PS>get-process powershell | debug-process Description ----------- Cette commande joint un débogueur aux processus PowerShell sur l'ordinateur. Elle utilise l'applet de commande Get-Process pour obtenir les processus PowerShell sur l'ordinateur et elle 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
C:\PS>$pid | debug-process Description ----------- Cette commande joint un débogueur aux processus PowerShell actifs sur l'ordinateur. Elle utilise la variable automatique $pid, qui contient l'identificateur du processus PowerShell actif. Elle utilise ensuite un opérateur de pipeline (|) pour envoyer l'identificateur du processus à l'applet de commande Debug-Process. Pour plus d'informations sur la variable automatique $pid, consultez about_Automatic_Variables.
Exemple 7
C:\PS>get-process -computername Server01, Server02 -name MyApp | debug-process Description ----------- Cette commande joint un débogueur aux processus MyApp sur les ordinateurs Server01 et Server02. Elle utilise l'applet de commande Get-Process pour obtenir les processus MyApp sur les ordinateurs Server01 et Server02. Elle utilise un opérateur de pipeline pour envoyer les processus à l'applet de commande Debug-Process, qui joint les débogueurs.
Exemple 8
C:\PS>$p = get-process powershell C:\PS> debug-process -inputobject $p Description ----------- Cette commande joint 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. Elle enregistre l'objet processus résultant dans la variable $p. La deuxième commande utilise le paramètre InputObject de Debug-Process pour envoyer l'objet processus qui figure dans la variable $p à Debug-Process.
Voir aussi