NOM
Debug-Process
RÉSUMÉ
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 [<SwitchParameter>]
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 [<SwitchParameter>]
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, WarningAction, WarningVariable, OutBuffer et OutVariable. Pour plus d'informations, tapez
« get-help about_commonparameters ».
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
Aucun
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 » (page éventuellement en anglais) dans MSDN Library, à l'adresse http://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.
LIENS CONNEXES
Online version: http://go.microsoft.com/fwlink/?LinkID=135206
Get-Process
Start-Process
Stop-Process
Wait-Process
Debug-Process
Aucun commentaire:
Enregistrer un commentaire