Debug-Job
Depura un trabajo remoto o en segundo plano en ejecución.
Syntax
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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | Int32 |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InstanceId
Especifica el GUID de identificador de instancia de un trabajo en ejecución.
Type: | Guid |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Job |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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
.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
System.Management.Automation.RemotingJob
Vínculos relacionados
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de