Compartir a través de

Debug-Job

  • Referencia
Módulo:
Microsoft.PowerShell.Core

Depura un trabajo remoto o en segundo plano en ejecución.

Sintaxis

Debug-Job
     [-Job] <Job>
     [-BreakAll]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Debug-Job
     [-Name] <String>
     [-BreakAll]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Debug-Job
     [-Id] <Int32>
     [-BreakAll]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Debug-Job
     [-InstanceId] <Guid>
     [-BreakAll]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

El Debug-Job cmdlet le permite depurar scripts que se ejecutan en trabajos. El cmdlet está diseñado para depurar trabajos de flujo de trabajo de PowerShell, trabajos en segundo plano y trabajos que se ejecutan en sesiones remotas. Debug-Job acepta un objeto de trabajo en ejecución, un nombre, un identificador o un identificador de instancia como entrada e inicia una sesión de depuración en el script que se está ejecutando. El comando del depurador quit detiene el trabajo y ejecuta el script. El exit comando desasocia el depurador y permite que el trabajo continúe ejecutándose.

Ejemplos

Ejemplo 1: Depuración de un trabajo por identificador de trabajo

Este comando se divide en un trabajo en ejecución con un identificador 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 interrumpir inmediatamente en la ubicación actual cuando el depurador se adjunta.

Este parámetro se agregó en PowerShell 7.2.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Id

Especifica el número de identificador de un trabajo en ejecución. Para obtener el número de identificador de un trabajo, ejecute el Get-Job cmdlet .

Tipo:Int32
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InstanceId

Especifica el GUID de identificador de instancia de un trabajo en ejecución.

Tipo:Guid
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Job

Especifica un objeto de trabajo en ejecución. La manera más sencilla de usar este parámetro es guardar los resultados de un Get-Job comando que devuelve el trabajo en ejecución que desea depurar en una variable y, a continuación, especificar la variable como el valor de este parámetro.

Tipo:Job
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Name

Especifica un trabajo por el nombre descriptivo del trabajo. Al iniciar un trabajo, puede especificar un nombre de trabajo agregando el parámetro JobName , en cmdlets como Invoke-Command y Start-Job.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

System.Management.Automation.RemotingJob