O cmdlet Debug-Job permite depurar scripts que estão em execução em trabalhos. O cmdlet foi projetado para depurar trabalhos do 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 da instância como entrada e inicia uma sessão de depuração no script em que está em execução. O comando quit depurador interrompe o trabalho e executa o script. O comando exit desanexa o depurador e permite que o trabalho continue a ser executado.
Exemplos
Exemplo 1: Depurar um trabalho por ID do trabalho
Esse comando divide 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
-BreakAll
Permite que você interrompa imediatamente no local atual quando o depurador é anexado.
Esse parâmetro foi adicionado ao PowerShell 7.2.
Propriedades do parâmetro
Tipo:
SwitchParameter
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Conjuntos de parâmetros
(All)
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Especifica um objeto de trabalho em execução. A maneira mais simples de usar esse parâmetro é salvar os resultados de um comando Get-Job que retorna o trabalho em execução que você deseja depurar em uma variável e especificar a variável como o valor desse parâmetro.
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.
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.