Compartir a través de

Debug-Process

Módulo:
Microsoft.PowerShell.Management Module

Depura uno o varios procesos que se ejecutan en el equipo local.

Sintaxis

Name (Es el valor predeterminado). 

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

Id 

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

InputObject 

Debug-Process
    -InputObject <Process[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

El cmdlet Debug-Process 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 registrado para el proceso. Antes de usar este cmdlet, compruebe que un depurador está instalado y configurado.

Ejemplos

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

Debug-Process -Name 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

Debug-Process -Name note*

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

Ejemplo 3: Adjuntar un depurador a varios procesos

Debug-Process "Winlogon", "Explorer", "Outlook"

Este comando intenta adjuntar un depurador a los procesos de Winlogon, Explorer y Outlook. Winlogon es un proceso protegido. Para depurar Winlogon, debe ejecutar el comando como administrador.

Ejemplo 4: Asociar un depurador a varios IDs de proceso

Debug-Process -Id 1132, 2028

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

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

Get-Process powershell | Debug-Process

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

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

Ejemplo 6: Adjuntar un depurador a un proceso en ejecución en el equipo local

 Debug-Process -Id $PID

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

El comando usa la variable automática $PID, 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 proceso al cmdlet Debug-Process.

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

Ejemplo 7: Adjuntar un depurador a un proceso que usa el parámetro InputObject

$P = Get-Process powershell
Debug-Process -InputObject $P

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

El primer comando usa el cmdlet Get-Process 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 cmdlet Debug-Process para enviar el objeto de proceso en la variable $P.

Parámetros

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Id

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

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

Propiedades del parámetro

Tipo:

Int32[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:PID, ProcessId

Conjuntos de parámetros

Id
Posición:0
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes: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 cmdlet Get-Process. También puede canalizar objetos de proceso a este cmdlet.

Propiedades del parámetro

Tipo:

Process[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

InputObject
Posición:Named
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:ProcessName

Conjuntos de parámetros

Name
Posición:0
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-WhatIf

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

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

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 ninguna salida.

Notas

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