Start-Job

Start-Job [-ScriptBlock] <scriptblock> [[-InitializationScript] <scriptblock>] [-ArgumentList <Object[]>] [-Authentication {<Default> | <Basic> | <Negotiate> | <NegotiateWithImplicitCredential> | <Credssp> | <Digest> | <Kerberos>}] [-Credential <PSCredential>] [-InputObject <psobject>] [-Name <string>] [-RunAs32] [<CommonParameters>]

Start-Job [[-FilePath] <string>] [[-InitializationScript] <scriptblock>] [-ArgumentList <Object[]>] [-Authentication {<Default> | <Basic> | <Negotiate> | <NegotiateWithImplicitCredential> | <Credssp> | <Digest> | <Kerberos>}] [-Credential <PSCredential>] [-InputObject <psobject>] [-Name <string>] [-RunAs32] [<CommonParameters>]

C:\PS>start-job -scriptblock {get-process}

C:\PS> start-job -command "get-process"

Id    Name  State    HasMoreData  Location   Command
---   ----  -----    -----------  --------   -------
1     Job1  Running  True         localhost  get-process

Description
-----------
Cette commande démarre une tâche en arrière-plan qui exécute une commande Get-Process. Elle retourne un objet de traitement avec des informations sur la tâche. L'invite de commandes se réaffiche immédiatement pour que vous puissiez travailler dans la session pendant que la tâche s'exécute en arrière-plan.

C:\PS>$jobWRM = invoke-command -computerName (get-content servers.txt) -scriptblock {get-service winrm} -jobname WinRM -throttlelimit 16 -AsJob

Description
-----------
Cette commande utilise l'applet de commande Invoke-Command et son paramètre AsJob pour démarrer une tâche en arrière-plan qui exécute une commande « get-service winrm » sur plusieurs ordinateurs. Parce que la commande s'exécute sur un serveur qui traite un trafic réseau substantiel, la commande utilise le paramètre ThrottleLimit d'Invoke-Command pour limiter à 16 le nombre de commandes simultanées. 

Cette commande utilise le paramètre ComputerName pour spécifier les ordinateurs sur lesquels la tâche s'exécute. La valeur du paramètre ComputerName est une commande Get-Content qui obtient le texte dans le fichier Servers.txt, un fichier de noms d'ordinateurs dans un domaine. 

La commande utilise le paramètre ScriptBlock pour spécifier la commande et le paramètre JobName pour spécifier un nom convivial pour la tâche.

C:\PS>$j = start-job -scriptblock {get-eventlog -log system} -credential domain01\user01

C:\PS> $j | format-list -property *

HasMoreData   : True
StatusMessage :
Location      : localhost
Command       : get-eventlog -log system
JobStateInfo  : Running
Finished      : System.Threading.ManualResetEvent
InstanceId    : 2d9d775f-63e0-4d48-b4bc-c05d0e177f34
Id            : 1
Name          : Job1
ChildJobs     : {Job2}
Output        : {}
Error         : {}
Progress      : {}
Verbose       : {}
Debug         : {}
Warning       : {}
StateChanged  :

C:\PS> $j.JobStateInfo.state
Completed

C:\PS> $results = receive-job -job $j

C:\PS> $results
Index Time          Type        Source                EventID Message
----- ----          ----        ------                ------- -------
84366 Feb 18 19:20  Information Service Control M...     7036 The description...
84365 Feb 18 19:16  Information Service Control M...     7036 The description...
84364 Feb 18 19:10  Information Service Control M...     7036 The description...
...

Description
-----------
Ces commandes gèrent une tâche en arrière-plan qui obtient tous les événements du journal Système dans l'Observateur d'événements. La tâche s'exécute sur l'ordinateur local.

La première commande utilise l'applet de commande Start-Job pour démarrer la tâche. Elle utilise le paramètre Credential pour spécifier le compte d'utilisateur d'un utilisateur qui a l'autorisation d'exécuter la tâche sur l'ordinateur. Elle enregistre ensuite l'objet de traitement que Start-Job retourne dans la variable $j.

À ce stade, vous pouvez reprendre votre travail pendant que la tâche ne s'achève.

La deuxième commande utilise un opérateur de pipeline (|) pour passer l'objet de traitement de $j à l'applet de commande Format-List. La commande Format-List utilise le paramètre Property avec une valeur visant à tout inclure (*) afin d'afficher toutes les propriétés de l'objet de traitement dans une liste.

La troisième commande affiche la valeur de la propriété JobStateInfo. Celle-ci contient l'état de la tâche.

La quatrième commande utilise l'applet de commande Receive-Job pour obtenir les résultats de la tâche. Elle stocke les résultats dans la variable $results.

La dernière commande affiche le contenu de la variable $results.

C:\PS>start-job -filepath c:\scripts\sample.ps1

Description
-----------
Cette commande exécute le script Sample.ps1 comme une tâche en arrière-plan.

C:\PS>start-job -name WinRm -scriptblock {get-process winrm}

Description
-----------
Cette commande exécute une tâche en arrière-plan qui obtient le processus WinRM sur l'ordinateur local. Elle utilise le paramètre ScriptBlock pour spécifier la commande qui s'exécute dans la tâche en arrière-plan. Elle utilise en outre le paramètre Name pour spécifier un nom convivial pour la nouvelle tâche.

C:\PS>start-job -name GetMappingFiles -initializationScript {import-module MapFunctions} -scriptblock {Get-Map -name * | set-content D:\Maps.tif} -runAs32

Description
-----------
Cette commande démarre une tâche qui collecte une grande quantité de données et les enregistre dans un fichier .tif. La commande utilise le paramètre InitializationScript pour exécuter un bloc de script qui importe un module requis. Elle utilise également le paramètre RunAs32 pour exécuter la tâche dans un processus 32 bits même si l'ordinateur est équipé d'un système d'exploitation 64 bits.