Debug-Process
Débogue un ou plusieurs processus en cours d'exécution sur l'ordinateur local.
Syntax
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 des 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 joint un débogueur au processus PowerShell sur l'ordinateur.
Exemple 2 : Attacher un débogueur à tous les processus qui commencent par la chaîne spécifiée
PS C:\> Debug-Process -Name "SQL*"
Cette commande joint un débogueur à tous les processus dont le nom commence par SQL.
Exemple 3 : Attacher un débogueur à plusieurs processus
PS C:\> Debug-Process "Winlogon", "Explorer", "Outlook"
Cette commande joint 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 joint un débogueur aux processus dont les identificateurs sont 1132 et 2028.
Exemple 5 : Utiliser Get-Process pour obtenir un processus, puis y attacher un débogueur
PS C:\> Get-Process "Windows 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 un opérateur de pipeline (|
) pour envoyer les processus à l’applet de Debug-Process
commande.
Pour spécifier un processus PowerShell particulier, utilisez le paramètre ID de Get-Process
.
Exemple 6 : Attacher un débogueur à un processus en cours sur l’ordinateur local
PS C:\> $PID | Debug-Process
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 de Debug-Process
commande.
Pour plus d’informations sur la $PID
variable automatique, 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 joint un débogueur aux processus PowerShell sur l'ordinateur local.
La première commande utilise l’applet de Get-Process
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 |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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[] |
Aliases: | PID, ProcessId |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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 de Get-Process
commande. Vous pouvez également diriger des objets de processus vers cette applet de commande.
Type: | Process[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Spécifie le nom des processus à déboguer. S’il existe plusieurs processus portant le même nom, cette applet de commande joint un débogueur à tous les processus portant ce nom. Le paramètre Name est facultatif.
Type: | String[] |
Aliases: | ProcessName |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
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 La méthode AttachDebugger dans la bibliothèque MSDN.