Debug-Process
Depura um ou mais processos em execução no computador local.
Debug-Process
[-Name] <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Debug-Process
[-Id] <Int32[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Debug-Process
-InputObject <Process[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
O Debug-Process
cmdlet anexa um depurador a um ou mais processos em execução em um computador local.
Você pode especificar os processos por seu nome de processo ou ID de processo (PID), ou pode canalizar objetos de processo para este cmdlet.
Este cmdlet anexa o depurador registrado para o processo. Antes de usar esse cmdlet, verifique se um depurador está instalado e configurado.
Debug-Process -Name Powershell
Este comando anexa um depurador ao processo do PowerShell no computador.
Exemplo 2: Anexar um depurador a todos os processos que começam com a cadeia de caracteres especificada
Debug-Process -Name note*
Este comando anexa um depurador a todos os processos que têm nomes que começam com note
.
Debug-Process "Winlogon", "Explorer", "Outlook"
Este comando tenta anexar um depurador aos processos Winlogon, Explorer e Outlook. Winlogon é um processo protegido. Para depurar o Winlogon, você deve executar o comando como administrador.
Debug-Process -Id 1132, 2028
Este comando anexa um depurador aos processos que têm IDs de processo 1132 e 2028.
Get-Process PowerShell | Debug-Process
Este comando anexa um depurador aos processos do PowerShell no computador. Ele usa o Get-Process
cmdlet para obter os processos do PowerShell no computador e usa um operador de pipeline (|
) para enviar os processos para o Debug-Process
cmdlet.
Para especificar um processo específico do PowerShell, use o parâmetro ID de Get-Process
.
Debug-Process -Id $PID
Este comando anexa um depurador aos processos atuais do PowerShell no computador.
O comando usa a $PID
variável automática, que contém a ID do processo do PowerShell atual. Em seguida, ele usa um operador de pipeline (|
) para enviar a ID do processo para o Debug-Process
cmdlet.
Para obter mais informações sobre a $PID
variável automática, consulte about_Automatic_Variables.
Get-Process -ComputerName "Server01", "Server02" -Name "MyApp" | Debug-Process
Este comando anexa um depurador aos processos MyApp nos computadores Server01 e Server02.
O comando usa o Get-Process
cmdlet para obter os processos MyApp nos computadores Server01 e Server02. Ele usa um operador de pipeline para enviar os processos para o Debug-Process
cmdlet, que anexa os depuradores.
$P = Get-Process PowerShell
Debug-Process -InputObject $P
Este comando anexa um depurador aos processos do PowerShell no computador local.
O primeiro comando usa o Get-Process
cmdlet para obter os processos do PowerShell no computador. Ele salva o objeto de processo resultante na variável chamada $P
.
O segundo comando usa o parâmetro InputObject do Debug-Process
cmdlet para enviar o objeto process na $P
variável.
Solicita a sua confirmação antes de executar o cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Especifica as IDs de processo dos processos a serem depurados. O nome do parâmetro Id é opcional.
Para localizar a ID do processo de um processo, digite Get-Process
.
Tipo: | Int32[] |
Aliases: | PID, ProcessId |
Position: | 0 |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
Especifica os objetos de processo que representam os processos a serem depurados. Insira uma variável que contenha os objetos de processo ou um comando que obtenha os objetos de processo, como o Get-Process
cmdlet. Você também pode canalizar objetos de processo para este cmdlet.
Tipo: | Process[] |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
Especifica os nomes dos processos a serem depurados. Se houver mais de um processo com o mesmo nome, esse cmdlet anexará um depurador a todos os processos com esse nome. O parâmetro Name é opcional.
Tipo: | String[] |
Aliases: | ProcessName |
Position: | 0 |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.
Tipo: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Você pode canalizar uma ID de processo para este cmdlet.
Você pode canalizar um objeto de processo para este cmdlet.
Você pode canalizar um nome de processo para este cmdlet.
None
Este cmdlet não retorna nenhuma saída.
Este cmdlet usa o método AttachDebugger da classe Win32_Process WMI (Instrumentação de Gerenciamento do Windows). Para obter mais informações sobre esse método, consulte AttachDebugger método na biblioteca MSDN.
Comentários do PowerShell
O PowerShell é um projeto código aberto. Selecione um link para fornecer comentários: