El cmdlet Debug-Job 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 está ejecutando. El depurador quit comando detiene el trabajo y ejecuta el script. El comando exit 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 asocia.
El parámetro solo está disponible como una característica experimental. Para obtener más información, consulte Uso de características experimentales.
Especifica un objeto de trabajo en ejecución. La manera más sencilla de usar este parámetro es guardar los resultados de un comando Get-Job 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.
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.
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.