Compartilhar via

Debug-Job

  • Referência
Módulo:
Microsoft.PowerShell.Core

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 cmdlet Debug-Job permite depurar scripts que estão em execução em trabalhos. O cmdlet foi projetado para depurar trabalhos de fluxo de trabalho do Windows 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 depurador encerrado comando interrompe o trabalho e executa o script. A partir do Windows PowerShell 5.0, o comando sair desanexa o depurador e permite que o trabalho continue a ser executado.

Exemplos

Exemplo 1: Depurar um trabalho por ID do trabalho

PS C:\> 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"

Esse comando divide um trabalho em execução com uma ID de 3.

Parâmetros

-Confirm

Solicita a 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 cmdlet Get-Job.

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 de ID da instância de um trabalho em execução. Para obter o InstanceId de um trabalho, execute o cmdlet Get-Job, canalizando os resultados para um cmdlet Format-* , conforme mostrado no exemplo a seguir:

Get-Job | Format-List -Property Id,Name,InstanceId,State

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

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