Debug-Job
Depura um trabalho em segundo plano, remoto ou de fluxo de trabalho do Windows PowerShell em execução.
Sintaxe
Debug-Job
[-Job] <Job>
[-WhatIf]
[-Confirm]
[<CommonParameters>]Debug-Job
[-Name] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]Debug-Job
[-Id] <Int32>
[-WhatIf]
[-Confirm]
[<CommonParameters>]Debug-Job
[-InstanceId] <Guid>
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
O Debug-Job cmdlet permite depurar scripts que estão sendo executados em trabalhos. O cmdlet foi projetado para depurar trabalhos de fluxo de trabalho do PowerShell, trabalhos em segundo plano e trabalhos em execução em sessões remotas. Debug-Job aceita um objeto de trabalho em execução, nome, ID ou ID de instância como entrada e inicia uma sessão de depuração no script que está sendo executado. O comando do depurador quit interrompe o trabalho e o script em execução. O exit comando desanexa o depurador e permite que o trabalho continue a ser executado.
Exemplos
Exemplo 1: Depurar um trabalho por ID de trabalho
Esse comando entra em um trabalho em execução com uma ID de 3.
Debug-Job -ID 3
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
3 Job3 RemoteJob Running True PowerShellIx TestWFDemo1.ps1
Entering debug mode. Use h or ? for help.
Hit Line breakpoint on 'C:\TestWFDemo1.ps1:8'
At C:\TestWFDemo1.ps1:8 char:5
+ Write-Output -InputObject "Now writing output:"
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
[DBG:PowerShellIx]: PS C:\> > list
3:
4: workflow SampleWorkflowTest
5: {
6: param ($MyOutput)
7:
8:* Write-Output -InputObject "Now writing output:"
9: Write-Output -Input $MyOutput
10:
11: Write-Output -InputObject "Get PowerShell process:"
12: Get-Process -Name powershell
13:
14: Write-Output -InputObject "Workflow function complete."
15: }
16:
17: # Call workflow function
18: SampleWorkflowTest -MyOutput "Hello"Parâmetros
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
| Tipo: | SwitchParameter |
| Aliases: | cf |
| Cargo: | Named |
| Valor padrão: | False |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Id
Especifica o número de ID de um trabalho em execução. Para obter o número de ID de um trabalho, execute o Get-Job cmdlet.
| Tipo: | Int32 |
| Cargo: | 0 |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-InstanceId
Especifica o GUID da ID da instância de um trabalho em execução.
| Tipo: | Guid |
| Cargo: | 0 |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Job
Especifica um objeto de trabalho em execução. A maneira mais simples de usar esse parâmetro é salvar os resultados de um Get-Job comando que retorna o trabalho em execução que você deseja depurar em uma variável e, em seguida, especificar a variável como o valor desse parâmetro.
| Tipo: | Job |
| Cargo: | 0 |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-Name
Especifica um trabalho pelo nome amigável do trabalho. Ao iniciar um trabalho, você pode especificar um nome de trabalho adicionando o parâmetro JobName , em cmdlets como Invoke-Command e Start-Job.
| Tipo: | String |
| Cargo: | 0 |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
| Tipo: | SwitchParameter |
| Aliases: | wi |
| Cargo: | Named |
| Valor padrão: | False |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
Entradas
System.Management.Automation.RemotingJob
