Debug-Process
Depura uno o varios procesos que se ejecutan en el equipo local.
Sintaxis
Name (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 que está registrado actualmente para el proceso. Antes de usar este cmdlet, compruebe que un depurador se ha descargado y configurado correctamente.
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 Windows 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: Adjuntar un depurador a varios procesos
PS C:\> Debug-Process "Winlogon", "Explorer", "Outlook"
Este comando asocia un depurador a los procesos de Winlogon, Explorer y Outlook.
Ejemplo 4: Asociar un depurador a varios IDs de proceso
PS C:\> 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
PS C:\> Get-Process "Windows PowerShell" | Debug-Process
Este comando asocia un depurador a los procesos de Windows PowerShell en el equipo. Usa el cmdlet Get-Process para obtener los procesos de Windows 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 Get-Process.
Ejemplo 6: Adjuntar un depurador a un proceso en ejecución en el equipo local
PS C:\> $PID | Debug-Process
Este comando asocia un depurador a los procesos actuales de Windows PowerShell en el equipo.
El comando usa el $PID variable automática, que contiene el identificador de proceso del proceso actual de Windows PowerShell. 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 $PID, consulte about_Automatic_Variables.
Ejemplo 7: Adjuntar un depurador al proceso especificado en varios equipos
PS C:\> Get-Process -ComputerName "Server01", "Server02" -Name "MyApp" | Debug-Process
Este comando asocia un depurador a los procesos MyApp en los equipos Server01 y Server02.
El comando usa el cmdlet Get-Process para obtener los procesos myApp en los equipos Server01 y Server02. Usa un operador de canalización para enviar los procesos al cmdlet Debug-Process, que asocia los depuradores.
Ejemplo 8: 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 Windows PowerShell en el equipo local.
El primer comando usa el cmdlet Get-Process para obtener los procesos de Windows PowerShell en el equipo. Guarda el objeto de proceso resultante en la variable denominada $P.
El segundo comando usa el parámetro
Parámetros
-Confirm
Le pide confirmación antes de ejecutar el cmdlet.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | 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 de 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 |
| Obligatorio: | 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 de parámetro
| Tipo: | Process[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
InputObject
| Posición: | Named |
| Obligatorio: | 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 de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | ProcessName |
Conjuntos de parámetros
Name
| Posición: | 0 |
| Obligatorio: | 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 de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | 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
System.Int32, System.Diagnostics.Process, System.String
Puede canalizar un identificador de proceso (Int32), un objeto de proceso (System.Diagnostics.Process) o un nombre de proceso (String) a este cmdlet.
Salidas
None
Este cmdlet no genera ningún resultado.
Notas
- Este cmdlet usa el método AttachDebugger de la clase Win32_Process de Instrumentación de Administración de Windows (WMI). Para obtener más información sobre este método, vea método AttachDebugger en MSDN Library.