about_Job_Details
Description courte
Fournit des détails sur les travaux en arrière-plan sur les ordinateurs locaux et distants.
Description détaillée
Cette rubrique explique le concept d’un travail en arrière-plan et fournit des informations techniques sur le fonctionnement des travaux en arrière-plan dans PowerShell.
Cette rubrique est un complément aux rubriques about_Jobs, about_Thread_Jobs et about_Remote_Jobs .
À propos des travaux en arrière-plan
Un travail en arrière-plan exécute une commande ou une expression de façon asynchrone. Il peut exécuter une applet de commande, une fonction, un script ou toute autre tâche basée sur une commande. Il est conçu pour exécuter des commandes qui prennent un certain temps, mais vous pouvez l’utiliser pour exécuter n’importe quelle commande en arrière-plan.
Lorsqu’une commande synchrone s’exécute, l’invite de commandes PowerShell est supprimée jusqu’à ce que la commande soit terminée. Toutefois, un travail en arrière-plan ne supprime pas l’invite PowerShell. Une commande pour démarrer un travail en arrière-plan retourne un objet de travail. L’invite retourne immédiatement afin que vous puissiez travailler sur d’autres tâches pendant l’exécution du travail en arrière-plan.
Toutefois, lorsque vous démarrez un travail en arrière-plan, vous n’obtenez pas les résultats immédiatement, même si le travail s’exécute très rapidement. L’objet de travail retourné contient des informations utiles sur le travail, mais il ne contient pas les résultats du travail. Vous devez exécuter une commande distincte pour obtenir les résultats du travail. Vous pouvez également exécuter des commandes pour arrêter le travail, pour attendre que le travail soit terminé et pour supprimer le travail.
Pour que le minutage d’un travail en arrière-plan soit indépendant des autres commandes, chaque travail en arrière-plan s’exécute dans sa propre session PowerShell. Toutefois, il peut s’agir d’une connexion temporaire qui est créée uniquement pour exécuter le travail et qui est ensuite détruite, ou il peut s’agir d’une session PSSession persistante que vous pouvez utiliser pour exécuter plusieurs travaux ou commandes associés.
Utilisation des applets de commande de travail
Utilisez une Start-Job commande pour démarrer un travail en arrière-plan sur un ordinateur local.
Start-Job retourne un objet de travail. Vous pouvez également obtenir des objets représentant les travaux qui ont été démarrés sur l’ordinateur local à l’aide de l’applet de Get-Job commande .
Pour obtenir les résultats du travail, utilisez une Receive-Job commande . Si le travail n’est pas terminé, Receive-Job retourne des résultats partiels. Vous pouvez également utiliser l’applet Wait-Job de commande pour supprimer l’invite de commandes jusqu’à ce que tous les travaux démarrés dans la session soient terminés.
Pour arrêter un travail en arrière-plan, utilisez l’applet de Stop-Job commande . Pour supprimer un travail, utilisez l’applet de Remove-Job commande .
Pour plus d’informations sur le fonctionnement des applets de commande, consultez la rubrique d’aide pour chaque applet de commande et about_Jobs.
Démarrage des travaux en arrière-plan sur des ordinateurs distants
Vous pouvez créer et gérer des travaux en arrière-plan sur un ordinateur local ou distant. Pour exécuter un travail en arrière-plan à distance, utilisez le paramètre AsJob d’une applet de commande telle que Invoke-Command, ou utilisez l’applet Invoke-Command de commande pour exécuter une Start-Job commande à distance. Vous pouvez également démarrer un travail en arrière-plan dans une session interactive.
Pour plus d’informations sur les travaux en arrière-plan distants, consultez about_Remote_Jobs.
Travaux enfants
Chaque travail en arrière-plan se compose d’un travail parent et d’un ou plusieurs travaux enfants. Dans les travaux commencés à utiliser Start-Job ou le paramètre AsJob de Invoke-Command, le travail parent est un cadre. Il n’exécute aucune commande ni ne retourne de résultats. Les commandes sont en fait exécutées par les travaux enfants. Les travaux commencés à utiliser d’autres applets de commande peuvent fonctionner différemment.
Les travaux enfants sont stockés dans la propriété ChildJobs de l’objet de travail parent. La propriété ChildJobs peut contenir un ou plusieurs objets de travail enfants. Les objets de travail enfants ont un Nom, un ID et un InstanceId qui diffèrent du travail parent afin que vous puissiez gérer les travaux parents et enfants individuellement ou en tant qu’unité.
Pour obtenir les travaux parent et enfant d’un travail, utilisez le paramètre IncludeChildJobs de l’applet Get-Job de commande . Le paramètre IncludeChildJob a été introduit dans Windows PowerShell 3.0.
PS> Get-Job -IncludeChildJob
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
1 Job1 RemoteJob Failed True localhost Get-Process
2 Job2 Completed True Server01 Get-Process
3 Job3 Failed False localhost Get-Process
Pour obtenir le travail parent et uniquement les travaux enfants avec une valeur d’état particulière, utilisez le paramètre ChildJobState de l’applet Get-Job de commande. Le paramètre ChildJobState a été introduit dans Windows PowerShell 3.0.
PS> Get-Job -ChildJobState Failed
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
1 Job1 RemoteJob Failed True localhost Get-Process
3 Job3 Failed False localhost Get-Process
Pour obtenir les travaux enfants d’un travail sur toutes les versions de PowerShell, utilisez la propriété ChildJob du travail parent.
PS> (Get-Job Job1).ChildJobs
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
2 Job2 Completed True Server01 Get-Process
3 Job3 Failed False localhost Get-Process
Vous pouvez également utiliser une Get-Job commande sur le travail enfant, comme indiqué dans la commande suivante :
PS> Get-Job Job3
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
3 Job3 Failed False localhost Get-Process
La configuration du travail enfant dépend de la commande que vous utilisez pour démarrer le travail.
Lorsque vous utilisez
Start-Jobpour démarrer un travail sur un ordinateur local, le travail se compose d’un travail parent exécutif et d’un travail enfant qui exécute la commande .Lorsque vous utilisez le paramètre AsJob de
Invoke-Commandpour démarrer un travail sur un ou plusieurs ordinateurs, le travail se compose d’un travail parent exécutif et d’un travail enfant pour chaque travail exécuté sur chaque ordinateur.Lorsque vous utilisez
Invoke-Commandpour exécuter une commande sur unStart-Jobou plusieurs ordinateurs distants, le résultat est le même qu’une commande locale exécutée sur chaque ordinateur distant. La commande retourne un objet de travail pour chaque ordinateur. L’objet de travail se compose d’un travail parent exécutif et d’un travail enfant qui exécute la commande .
Le travail parent représente tous les travaux enfants. Lorsque vous gérez un travail parent, vous gérez également les travaux enfants associés. Par exemple, si vous arrêtez un travail parent, tous les travaux enfants sont arrêtés. Si vous obtenez les résultats d’un travail parent, vous obtenez les résultats de tous les travaux enfants.
Toutefois, vous pouvez également gérer les travaux enfants individuellement. Cela est particulièrement utile lorsque vous souhaitez examiner un problème avec un travail ou obtenir les résultats d’un seul des nombreux travaux enfants démarrés à l’aide du paramètre AsJob de Invoke-Command.
La commande suivante utilise le paramètre AsJob de pour démarrer les Invoke-Command travaux en arrière-plan sur l’ordinateur local et sur deux ordinateurs distants. La commande enregistre le travail dans la $j variable .
PS> $j = Invoke-Command -ComputerName localhost, Server01, Server02 `
-Command {Get-Date} -AsJob
Lorsque vous affichez les propriétés Name et ChildJob du travail dans $j, la commande a renvoyé un objet de travail avec trois travaux enfants, un pour chaque ordinateur.
PS> $j | Format-List Name, ChildJobs
Name : Job3
ChildJobs : {Job4, Job5, Job6}
Lorsque vous affichez le travail parent, cela indique que le travail a échoué.
PS> $j
Id Name PSJobTypeName State HasMoreData Location
-- ---- ------------- ----- ----------- --------
3 Job3 RemotingJob Failed False localhost,Server...
Toutefois, lorsque vous exécutez une Get-Job commande qui obtient les travaux enfants, la sortie indique qu’un seul travail enfant a échoué.
PS> Get-Job -IncludeChildJobs
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
3 Job3 RemotingJob Failed False localhost,Server...
4 Job4 Completed True localhost Get-Date
5 Job5 Failed False Server01 Get-Date
6 Job6 Completed True Server02 Get-Date
Pour obtenir les résultats de tous les travaux enfants, utilisez l’applet Receive-Job de commande pour obtenir les résultats du travail parent. Mais vous pouvez également obtenir les résultats d’un travail enfant particulier, comme illustré dans la commande suivante.
PS> Receive-Job -Name Job6 -Keep | Format-Table ComputerName,
>> DateTime -AutoSize
ComputerName DateTime
------------ --------
Server02 Thursday, March 13, 2008 4:16:03 PM
La fonctionnalité de travaux enfants des travaux en arrière-plan PowerShell vous donne plus de contrôle sur les travaux que vous exécutez.
Types de travaux
PowerShell prend en charge différents types de travaux pour différentes tâches. À compter de Windows PowerShell 3.0, les développeurs peuvent écrire des « adaptateurs de source de travail » qui ajoutent de nouveaux types de travaux à PowerShell et incluent les adaptateurs de source de travail dans les modules. Lorsque vous importez le module, vous pouvez utiliser le nouveau type de travail dans votre session.
Par exemple, le module PSScheduledJob ajoute des travaux planifiés et le module PSWorkflow ajoute des travaux de flux de travail.
Les types de travaux personnalisés peuvent différer considérablement des travaux en arrière-plan PowerShell standard. Par exemple, les travaux planifiés sont enregistrés sur le disque ; ils n’existent pas seulement dans une session particulière. Les travaux de flux de travail peuvent être suspendus et repris.
Les applets de commande que vous utilisez pour gérer les travaux personnalisés dépendent du type de travail. Pour certains, vous utilisez les applets de commande de travail standard, telles que Get-Job et Start-Job. D’autres sont fournies avec des applets de commande spécialisées qui gèrent uniquement un type particulier de travail. Pour plus d’informations sur les types de travaux personnalisés, consultez les rubriques d’aide sur le type de travail.
Pour rechercher le type de travail d’un travail, utilisez l’applet de Get-Job commande . Get-Job retourne différents objets de travail pour différents types de travaux. La valeur de la propriété PSJobTypeName des objets de travail qui Get-Job retourne indique le type de travail.
Le tableau suivant répertorie les types de travaux fournis avec PowerShell.
| Type de travail | Description |
|---|---|
| BackgroundJob | Commencé à utiliser l’applet de Start-Job commande . |
| RemoteJob | Commencé à utiliser le paramètre AsJob du |
Invoke-Command. |
|
| PSWorkflowJob | Commencé à utiliser le paramètre AsJob d’un flux de travail. |
| PSScheduledJob | Instance d’un travail planifié démarré par un déclencheur de travail. |
| CIMJob | Commencé à utiliser le paramètre AsJob d’une applet de commande à partir d’un |
| Module CDXML. | |
| WMIJob | Commencé à utiliser le paramètre AsJob d’une applet de commande à partir d’un |
| Module WMI. | |
| PSEventJob | Créé à l’aideRegister-ObjectEvent et en spécifiant un |
| avec le paramètre Action . |
REMARQUE : avant d’utiliser l’applet Get-Job de commande pour obtenir des travaux d’un type particulier, vérifiez que le module qui ajoute le type de travail est importé dans la session active.
Sinon, Get-Job n’obtient pas de travaux de ce type.
Exemples
Les commandes suivantes créent un travail en arrière-plan local, un travail en arrière-plan distant, un travail de workflow et un travail planifié. Ensuite, il utilise l’applet de Get-Job commande pour obtenir les travaux. Get-Job n’obtient pas le travail planifié, mais il obtient toutes les instances de démarrage du travail planifié.
Démarrez un travail en arrière-plan sur l’ordinateur local.
PS> Start-Job -Name LocalData {Get-Process}
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
2 LocalData BackgroundJob Running True localhost Get-Process
Démarrez un travail en arrière-plan qui s’exécute sur un ordinateur distant.
PS> Invoke-Command -ComputerName Server01 {Get-Process} `
-AsJob -JobName RemoteData
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
2 RemoteData RemoteJob Running True Server01 Get-Process
Créer une tâche planifiée
PS> Register-ScheduledJob -Name ScheduledJob -ScriptBlock `
{Get-Process} -Trigger (New-JobTrigger -Once -At "3 PM")
Id Name JobTriggers Command Enabled
-- ---- ----------- ------- -------
1 ScheduledJob 1 Get-Process True
Create un workflow.
PS> workflow Test-Workflow {Get-Process}
Exécutez le flux de travail en tant que travail.
PS> Test-Workflow -AsJob -JobName TestWFJob
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
2 TestWFJob PSWorkflowJob NotStarted True localhost Get-Process
Obtenez les travaux. La Get-Job commande n’obtient pas de travaux planifiés, mais elle obtient des instances du travail planifié qui sont démarrées.
PS> Get-Job
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
2 LocalData BackgroundJob Completed True localhost Get-Process
4 RemoteData RemoteJob Completed True Server01 Get-Process
6 TestWFJob PSWorkflowJob Completed True localhost WorkflowJob
8 ScheduledJob PSScheduledJob Completed True localhost Get-Process
Pour obtenir des travaux planifiés, utilisez l’applet de Get-ScheduledJob commande .
PS> Get-ScheduledJob
Id Name JobTriggers Command Enabled
-- ---- ----------- ------- -------
1 ScheduledJob 1 Get-Process True