Debug-Process

  • Referencia
Módulo:
Microsoft.PowerShell.Management

Depura uno o más procesos que se ejecutan en el equipo local.

Syntax

Debug-Process
     [-Name] <String[]>
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Debug-Process
     [-Id] <Int32[]>
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Debug-Process
     -InputObject <Process[]>
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

El Debug-Process cmdlet asocia un depurador a uno o varios procesos en ejecución en un equipo local. Puede especificar los procesos por su nombre de proceso o identificador de proceso (PID) o puede canalizar objetos de proceso a este cmdlet.

Este cmdlet asocia el depurador que está registrado actualmente para el proceso. Antes de usar este cmdlet, confirme que se ha descargado un depurador y que este está correctamente configurado.

Ejemplos

Ejemplo 1: Adjuntar un depurador a un proceso en el equipo

PS C:\> Debug-Process -Name "Windows Powershell"

Este comando asocia un depurador al proceso de PowerShell en el equipo.

Ejemplo 2: Adjuntar un depurador a todos los procesos que comienzan con la cadena especificada

PS C:\> Debug-Process -Name "SQL*"

Este comando asocia un depurador a todos los procesos que tienen nombres que comienzan por SQL.

Ejemplo 3: Asociación de un depurador a varios procesos

PS C:\> Debug-Process "Winlogon", "Explorer", "Outlook"

Este comando asocia un depurador a los procesos Winlogon, Explorer y Outlook.

Ejemplo 4: Adjuntar un depurador a varios identificadores de proceso

PS C:\> Debug-Process -Id 1132, 2028

Este comando asocia un depurador a los procesos con los identificadores de proceso 1132 y 2028.

Ejemplo 5: Usar Get-Process para obtener un proceso y, a continuación, adjuntar un depurador a él

PS C:\> Get-Process "Windows PowerShell" | Debug-Process

Este comando asocia un depurador a los procesos de PowerShell en el equipo. Usa el Get-Process cmdlet para obtener los procesos de PowerShell en el equipo y usa un operador de canalización (|) para enviar los procesos al Debug-Process cmdlet .

Para especificar un proceso determinado de PowerShell, use el parámetro ID de Get-Process.

Ejemplo 6: Asociación de un depurador a un proceso actual en el equipo local

PS C:\> $PID | Debug-Process

Este comando asocia un depurador a los procesos de PowerShell actuales en el equipo.

El comando usa la $PID variable automática, que contiene el identificador de proceso del proceso de PowerShell actual. A continuación, usa un operador de canalización (|) para enviar el identificador de Debug-Process proceso al cmdlet .

Para obtener más información sobre la $PID variable automática, consulte about_Automatic_Variables.

Ejemplo 7: Asociación de un depurador a un proceso que usa el parámetro InputObject

PS C:\> $P = Get-Process "Windows PowerShell"
PS C:\> Debug-Process -InputObject $P

Este comando asocia un depurador a los procesos de PowerShell en el equipo local.

El primer comando usa el Get-Process cmdlet para obtener los procesos de PowerShell en el equipo. Guarda el objeto de proceso resultante en la variable denominada $P.

El segundo comando usa el parámetro InputObject del Debug-Process cmdlet para enviar el objeto de proceso en la $P variable .

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Especifica los identificadores de proceso de los procesos que se van a depurar. El nombre del parámetro Id es opcional.

Para buscar el identificador de proceso de un proceso, escriba Get-Process.

Type:Int32[]
Aliases:PID, ProcessId
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-InputObject

Especifica los objetos de proceso que representan los procesos que se van a depurar. Escriba una variable que contenga los objetos de proceso o un comando que obtiene los objetos de proceso, como el Get-Process cmdlet . También puede canalizar objetos de proceso a este cmdlet.

Type:Process[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Especifica los nombres de los procesos que se van a depurar. Si hay más de un proceso con el mismo nombre, este cmdlet adjunta un depurador a todos los procesos con ese nombre. El parámetro Name es opcional.

Type:String[]
Aliases:ProcessName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Int32

Puede canalizar un identificador de proceso a este cmdlet.

Process

Puede canalizar un objeto de proceso a este cmdlet.

String

Puede canalizar un nombre de proceso a este cmdlet.

Salidas

None

Este cmdlet no devuelve ningún resultado.

Notas

Este cmdlet usa el método AttachDebugger de la clase Win32_Process de Instrumental de administración de Windows (WMI). Para obtener más información sobre este método, vea Método AttachDebugger en MSDN Library.