Partager via


Start-Job

Démarre un travail en arrière-plan PowerShell.

Syntaxe

Start-Job
     [-Name <String>]
     [-ScriptBlock] <ScriptBlock>
     [-Credential <PSCredential>]
     [-Authentication <AuthenticationMechanism>]
     [[-InitializationScript] <ScriptBlock>]
     [-WorkingDirectory <String>]
     [-RunAs32]
     [-PSVersion <Version>]
     [-InputObject <PSObject>]
     [-ArgumentList <Object[]>]
     [<CommonParameters>]
Start-Job
     [-DefinitionName] <String>
     [[-DefinitionPath] <String>]
     [[-Type] <String>]
     [-WorkingDirectory <String>]
     [<CommonParameters>]
Start-Job
     [-Name <String>]
     [-Credential <PSCredential>]
     [-FilePath] <String>
     [-Authentication <AuthenticationMechanism>]
     [[-InitializationScript] <ScriptBlock>]
     [-WorkingDirectory <String>]
     [-RunAs32]
     [-PSVersion <Version>]
     [-InputObject <PSObject>]
     [-ArgumentList <Object[]>]
     [<CommonParameters>]
Start-Job
     [-Name <String>]
     [-Credential <PSCredential>]
     -LiteralPath <String>
     [-Authentication <AuthenticationMechanism>]
     [[-InitializationScript] <ScriptBlock>]
     [-WorkingDirectory <String>]
     [-RunAs32]
     [-PSVersion <Version>]
     [-InputObject <PSObject>]
     [-ArgumentList <Object[]>]
     [<CommonParameters>]

Description

L’applet de commande Start-Job démarre un travail en arrière-plan PowerShell sur l’ordinateur local.

Un travail en arrière-plan PowerShell exécute une commande sans interagir avec la session active. Lorsque vous démarrez un travail en arrière-plan, un objet de travail retourne immédiatement, même si le travail prend un certain temps pour se terminer. Vous pouvez continuer à travailler dans la session sans interruption pendant l'exécution de la tâche.

L’objet de travail contient des informations utiles sur le travail, mais il ne contient pas les résultats du travail. Une fois le travail terminé, utilisez l’applet de commande Receive-Job pour obtenir les résultats du travail. Pour plus d’informations sur les travaux en arrière-plan, consultez about_Jobs.

Pour exécuter un travail en arrière-plan sur un ordinateur distant, utilisez le paramètre AsJob disponible sur de nombreuses applets de commande ou utilisez l’applet de commande Invoke-Command pour exécuter une commande Start-Job sur l’ordinateur distant. Pour plus d’informations, consultez about_Remote_Jobs.

À compter de PowerShell 3.0, Start-Job pouvez démarrer des instances de types de travaux personnalisés, telles que des travaux planifiés. Pour plus d’informations sur l’utilisation de Start-Job pour démarrer des travaux avec des types personnalisés, consultez les documents d’aide pour la fonctionnalité de type de travail.

À compter de PowerShell 6.0, vous pouvez démarrer des travaux à l’aide de l’opérateur d’arrière-plan ampersand (&). La fonctionnalité de l’opérateur d’arrière-plan est similaire à Start-Job. Les deux méthodes pour démarrer un travail créent un objet de travail PSRemotingJob. Pour plus d’informations sur l’utilisation de l’ampersand (&), consultez about_Operators.

PowerShell 7 a introduit le paramètre WorkingDirectory qui spécifie le répertoire de travail initial d’un travail en arrière-plan. Si le paramètre n’est pas spécifié, Start-Job est défini par défaut sur le répertoire de travail actuel de l’appelant qui a démarré le travail.

Remarque

La création d’un travail en arrière-plan hors processus avec Start-Job n’est pas prise en charge dans le scénario où PowerShell est hébergé dans d’autres applications, telles que PowerShell Azure Functions.

Cela est dû à la conception, car Start-Job dépend de l’exécutable pwsh disponible sous $PSHOME pour démarrer un travail en arrière-plan hors processus, mais lorsqu’une application héberge PowerShell, elle utilise directement les packages du Kit de développement logiciel (SDK) NuGet PowerShell et n’a pas pwsh livré.

Le remplacement dans ce scénario est Start-ThreadJob à partir du module ThreadJob.

Exemples

Exemple 1 : Démarrer un travail en arrière-plan

Cet exemple démarre un travail en arrière-plan qui s’exécute sur l’ordinateur local.

Start-Job -ScriptBlock { Get-Process -Name pwsh }

Id  Name   PSJobTypeName   State     HasMoreData   Location    Command
--  ----   -------------   -----     -----------   --------    -------
1   Job1   BackgroundJob   Running   True          localhost   Get-Process -Name pwsh

Start-Job utilise le paramètre ScriptBlock pour exécuter Get-Process en tant que travail en arrière-plan. Le paramètre Name spécifie pour rechercher les processus PowerShell, pwsh. Les informations de travail sont affichées et PowerShell retourne à une invite pendant que le travail s’exécute en arrière-plan.

Pour afficher la sortie du travail, utilisez l’applet de commande Receive-Job. Par exemple, Receive-Job -Id 1.

Exemple 2 : Utiliser l’opérateur en arrière-plan pour démarrer un travail en arrière-plan

Cet exemple utilise l’opérateur d’arrière-plan ampersand (&) pour démarrer un travail en arrière-plan sur l’ordinateur local. Le travail obtient le même résultat que Start-Job dans l’exemple 1.

Get-Process -Name pwsh &

Id    Name   PSJobTypeName   State       HasMoreData     Location      Command
--    ----   -------------   -----       -----------     --------      -------
5     Job5   BackgroundJob   Running     True            localhost     Microsoft.PowerShell.Man...

Get-Process utilise le paramètre Name pour spécifier les processus PowerShell, pwsh. L’ampersand (&) exécute la commande en tant que travail en arrière-plan. Les informations de travail sont affichées et PowerShell retourne à une invite pendant que le travail s’exécute en arrière-plan.

Pour afficher la sortie du travail, utilisez l’applet de commande Receive-Job. Par exemple, Receive-Job -Id 5.

Exemple 3 : Démarrer un travail à l’aide de Invoke-Command

Cet exemple exécute un travail sur plusieurs ordinateurs. Le travail est stocké dans une variable et est exécuté à l’aide du nom de la variable sur la ligne de commande PowerShell.

$jobWRM = Invoke-Command -ComputerName (Get-Content -Path C:\Servers.txt) -ScriptBlock {
   Get-Service -Name WinRM } -JobName WinRM -ThrottleLimit 16 -AsJob

Un travail qui utilise Invoke-Command est créé et stocké dans la variable $jobWRM. Invoke-Command utilise le paramètre ComputerName pour spécifier les ordinateurs sur lesquels le travail s’exécute. Get-Content obtient les noms du serveur à partir du fichier C:\Servers.txt.

Le paramètre ScriptBlock spécifie une commande qui Get-Service obtient le service WinRM. Le paramètre JobName spécifie un nom convivial pour le travail WinRM. Le paramètre ThrottleLimit limite le nombre de commandes simultanées à 16. Le paramètre AsJob démarre un travail en arrière-plan qui exécute la commande sur les serveurs.

Exemple 4 : Obtenir des informations sur le travail

Cet exemple obtient des informations sur un travail et affiche les résultats d’un travail terminé qui a été exécuté sur l’ordinateur local.

$j = Start-Job -ScriptBlock { Get-WinEvent -Log System } -Credential Domain01\User01
$j | Select-Object -Property *

State         : Completed
HasMoreData   : True
StatusMessage :
Location      : localhost
Command       : Get-WinEvent -Log System
JobStateInfo  : Completed
Finished      : System.Threading.ManualResetEvent
InstanceId    : 27ce3fd9-40ed-488a-99e5-679cd91b9dd3
Id            : 18
Name          : Job18
ChildJobs     : {Job19}
PSBeginTime   : 8/8/2019 14:41:57
PSEndTime     : 8/8/2019 14:42:07
PSJobTypeName : BackgroundJob
Output        : {}
Error         : {}
Progress      : {}
Verbose       : {}
Debug         : {}
Warning       : {}
Information   : {}

Start-Job utilise le paramètre ScriptBlock pour exécuter une commande qui spécifie Get-WinEvent pour obtenir le journal des système. Le paramètre Credential spécifie un compte d’utilisateur de domaine avec l’autorisation d’exécuter le travail sur l’ordinateur. L’objet de travail est stocké dans la variable $j.

L’objet de la variable $j est envoyé vers le bas du pipeline pour Select-Object. Le paramètre Property spécifie un astérisque (*) pour afficher toutes les propriétés de l’objet de travail.

Exemple 5 : Exécuter un script en tant que travail en arrière-plan

Dans cet exemple, un script sur l’ordinateur local est exécuté en tant que travail en arrière-plan.

Start-Job -FilePath C:\Scripts\Sample.ps1

Start-Job utilise le paramètre FilePath pour spécifier un fichier de script stocké sur l’ordinateur local.

Exemple 6 : Obtenir un processus à l’aide d’un travail en arrière-plan

Cet exemple utilise un travail en arrière-plan pour obtenir un processus spécifié par nom.

Start-Job -Name PShellJob -ScriptBlock { Get-Process -Name PowerShell }

Start-Job utilise le paramètre Name pour spécifier un nom de travail convivial PShellJob. Le paramètre ScriptBlock spécifie Get-Process pour obtenir des processus portant le nom PowerShell.

Exemple 7 : Collecter et enregistrer des données à l’aide d’un travail en arrière-plan

Cet exemple démarre un travail qui collecte une grande quantité de données cartographiques, puis l’enregistre dans un fichier .tif.

Start-Job -Name GetMappingFiles -InitializationScript {Import-Module -Name MapFunctions} -ScriptBlock {
   Get-Map -Name * | Set-Content -Path D:\Maps.tif }

Start-Job utilise le paramètre Name pour spécifier un nom de travail convivial, GetMappingFiles. Le paramètre InitializationScript exécute un bloc de script qui importe le module MapFunctions. Le paramètre ScriptBlock s’exécute Get-Map et Set-Content enregistre les données à l’emplacement spécifié par le paramètre Path.

Exemple 8 : Passer une entrée à un travail en arrière-plan

Cet exemple utilise la variable automatique $input pour traiter un objet d’entrée. Utilisez Receive-Job pour afficher la sortie du travail.

Start-Job -ScriptBlock { Get-Content -Path $input } -InputObject "C:\Servers.txt"
Receive-Job -Name Job45 -Keep

Server01
Server02
Server03
Server04

Start-Job utilise le paramètre ScriptBlock pour exécuter Get-Content avec la variable automatique $input. La variable $input obtient des objets du paramètre InputObject. Receive-Job utilise le paramètre Name pour spécifier le travail et générer les résultats. Le paramètre Keep enregistre la sortie du travail afin qu’elle puisse être réentrésistée pendant la session PowerShell.

Exemple 9 : Définir le répertoire de travail d’un travail en arrière-plan

Le WorkingDirectory vous permet de spécifier un autre répertoire pour un travail à partir duquel vous pouvez exécuter des scripts ou ouvrir des fichiers. Dans cet exemple, le travail en arrière-plan spécifie un répertoire de travail différent de l’emplacement du répertoire actif.

PS C:\Test> Start-Job -WorkingDirectory C:\Test\Scripts { $PWD } | Receive-Job -AutoRemoveJob -Wait

Path
----
C:\Test\Scripts

Le répertoire de travail actuel de cet exemple est C:\Test. Start-Job utilise le paramètre WorkingDirectory pour spécifier le répertoire de travail du travail. Le paramètre ScriptBlock utilise $PWD pour afficher le répertoire de travail du travail. Receive-Job affiche la sortie du travail en arrière-plan. AutoRemoveJob supprime le travail et wait supprime l’invite de commandes jusqu’à ce que tous les résultats soient reçus.

Exemple 10 : Utiliser le paramètre ArgumentList pour spécifier un tableau

Cet exemple utilise le paramètre ArgumentList pour spécifier un tableau d’arguments. Le tableau est une liste séparée par des virgules de noms de processus.

Start-Job -ScriptBlock { Get-Process -Name $args } -ArgumentList powershell, pwsh, notepad

Id     Name      PSJobTypeName   State       HasMoreData     Location     Command
--     ----      -------------   -----       -----------     --------     -------
1      Job1      BackgroundJob   Running     True            localhost    Get-Process -Name $args

L’applet de commande Start-Job utilise le paramètre ScriptBlock pour exécuter une commande. Get-Process utilise le paramètre Name pour spécifier la variable automatique $args. Le paramètre ArgumentList transmet le tableau de noms de processus à $args. Les noms de processus powershell, pwsh et bloc-notes sont des processus en cours d’exécution sur l’ordinateur local.

Pour afficher la sortie du travail, utilisez l’applet de commande Receive-Job. Par exemple, Receive-Job -Id 1.

Exemple 11 : Exécuter un travail dans Windows PowerShell 5.1

Cet exemple utilise le paramètre PSVersion avec la valeur 5.1 pour exécuter un travail dans une session Windows PowerShell 5.1.

$PSVersionTable.PSVersion

Major  Minor  Patch  PreReleaseLabel BuildLabel
-----  -----  -----  --------------- ----------
7      0      0      rc.1

$job = Start-Job -ScriptBlock { $PSVersionTable.PSVersion } -PSVersion 5.1
Receive-Job -Job $job

Major  Minor  Build  Revision
-----  -----  -----  --------
5      1      14393  3383

Paramètres

-ArgumentList

Spécifie un tableau d’arguments ou de valeurs de paramètre pour le script spécifié par le paramètre FilePath ou une commande spécifiée avec le paramètre ScriptBlock.

Les arguments doivent être passés à ArgumentList en tant qu’argument de tableau à dimension unique. Par exemple, une liste séparée par des virgules. Pour plus d'informations sur le comportement d'ArgumentList, voir about_Splatting.

Type:Object[]
Alias:Args
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Authentication

Spécifie le mécanisme utilisé pour authentifier les informations d’identification de l’utilisateur.

Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Par défaut
  • Élémentaire
  • Credssp
  • Digérer
  • Kerberos
  • Négocier
  • NegotiateWithImplicitCredential

La valeur par défaut est Default.

L’authentification CredSSP est disponible uniquement dans Windows Vista, Windows Server 2008 et versions ultérieures du système d’exploitation Windows.

Pour plus d’informations sur les valeurs de ce paramètre, consultez AuthenticationMechanism.

Avertissement

L’authentification CredSSP (Credential Security Support Provider), dans laquelle les informations d’identification de l’utilisateur sont transmises à un ordinateur distant à authentifier, est conçue pour les commandes qui nécessitent une authentification sur plusieurs ressources, telles que l’accès à un partage réseau distant. Ce mécanisme augmente le risque de sécurité de l’opération à distance. Si l’ordinateur distant est compromis, les informations d’identification qui lui sont transmises peuvent être utilisées pour contrôler la session réseau.

Type:AuthenticationMechanism
Valeurs acceptées:Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos
Position:Named
Valeur par défaut:Default
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Credential

Spécifie un compte d’utilisateur autorisé à effectuer cette action. Si le paramètre Credential n’est pas spécifié, la commande utilise les informations d’identification de l’utilisateur actuel.

Tapez un nom d’utilisateur, tel que User01 ou Domain01\User01, ou entrez un objet PSCredential généré par l’applet de commande Get-Credential. Si vous tapez un nom d’utilisateur, vous êtes invité à entrer le mot de passe.

Les informations d’identification sont stockées dans un objet PSCredential et le mot de passe est stocké en tant que SecureString.

Remarque

Pour plus d'informations sur la protection des données de SecureString, consultez Quelle est la sécurité de SecureString ?.

Type:PSCredential
Position:Named
Valeur par défaut:Current user
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DefinitionName

Spécifie le nom de définition du travail démarré par cette applet de commande. Utilisez ce paramètre pour démarrer des types de travaux personnalisés qui ont un nom de définition, tel que des travaux planifiés.

Lorsque vous utilisez Start-Job pour démarrer une instance d’un travail planifié, le travail démarre immédiatement, quel que soit le déclencheur de travail ou les options de travail. L’instance de travail résultante est une tâche planifiée, mais elle n’est pas enregistrée sur le disque, comme les travaux planifiés déclenchés. Vous ne pouvez pas utiliser le paramètre ArgumentList de Start-Job pour fournir des valeurs pour les paramètres des scripts qui s’exécutent dans un travail planifié.

Ce paramètre a été introduit dans PowerShell 3.0.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DefinitionPath

Spécifie le chemin d’accès de la définition du travail démarré par cette applet de commande. Entrez le chemin de définition. La concaténation des valeurs des paramètres DefinitionPath et DefinitionName est le chemin complet de la définition de travail. Utilisez ce paramètre pour démarrer des types de travaux personnalisés qui ont un chemin de définition, tel que des travaux planifiés.

Pour les travaux planifiés, la valeur du paramètre DefinitionPath est $HOME\AppData\Local\Windows\PowerShell\ScheduledJob.

Ce paramètre a été introduit dans PowerShell 3.0.

Type:String
Position:1
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-FilePath

Spécifie un script local qui Start-Job s’exécute en tant que travail en arrière-plan. Entrez le chemin d’accès et le nom du fichier du script ou utilisez le pipeline pour envoyer un chemin de script à Start-Job. Le script doit se trouver sur l’ordinateur local ou dans un dossier auquel l’ordinateur local peut accéder.

Lorsque vous utilisez ce paramètre, PowerShell convertit le contenu du fichier de script spécifié en bloc de script et exécute le bloc de script en tant que travail en arrière-plan.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InitializationScript

Spécifie les commandes qui s’exécutent avant le démarrage du travail. Pour créer un bloc de script, placez les commandes en accolades ({}).

Utilisez ce paramètre pour préparer la session dans laquelle le travail s’exécute. Par exemple, vous pouvez l’utiliser pour ajouter des fonctions, des composants logiciels enfichables et des modules à la session.

Type:ScriptBlock
Position:1
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputObject

Spécifie l'entrée de la commande. Entrez une variable qui contient les objets, ou tapez une commande ou une expression qui génère les objets.

Dans la valeur du paramètre ScriptBlock, utilisez la variable automatique $input pour représenter les objets d’entrée.

Type:PSObject
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-LiteralPath

Spécifie un script local que cette applet de commande s’exécute en tant que travail en arrière-plan. Entrez le chemin d’accès d’un script sur l’ordinateur local.

Start-Job utilise la valeur du paramètre LiteralPath exactement tel qu’il est typé. Aucun caractère n'est interprété en tant que caractère générique. Si le chemin d’accès inclut des caractères d’échappement, mettez-le entre des guillemets simples. Les guillemets simples indiquent à PowerShell de ne pas interpréter de caractères comme séquences d’échappement.

Type:String
Alias:PSPath, LP
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifie un nom convivial pour le nouveau travail. Vous pouvez utiliser le nom pour identifier le travail à d’autres applets de commande de travail, telles que l’applet de commande Stop-Job.

Le nom convivial par défaut est Job#, où # est un nombre ordinal incrémenté pour chaque travail.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-PSVersion

Spécifie une version de PowerShell à utiliser pour exécuter le travail. Lorsque la valeur de psVersion est 5.1 Le travail est exécuté dans une session Windows PowerShell 5.1. Pour toute autre valeur, le travail est exécuté à l’aide de la version actuelle de PowerShell.

Ce paramètre a été ajouté dans PowerShell 7 et fonctionne uniquement sur Windows.

Type:Version
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RunAs32

À compter de PowerShell 7, le paramètre RunAs32 ne fonctionne pas sur PowerShell 64 bits (pwsh). Si runAs32 est spécifié dans PowerShell 64 bits, Start-Job lève une erreur d’exception de fin. Pour démarrer un processus PowerShell 32 bits (pwsh) avec RunAs32, vous devez installer PowerShell 32 bits.

Dans PowerShell 32 bits, RunAs32 force le travail à s’exécuter dans un processus 32 bits, même sur un système d’exploitation 64 bits.

Sur les versions 64 bits de Windows 7 et Windows Server 2008 R2, lorsque la commande Start-Job inclut le paramètre RunAs32, vous ne pouvez pas utiliser le paramètre d’informations d’identification pour spécifier les informations d’identification d’un autre utilisateur.

Type:SwitchParameter
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ScriptBlock

Spécifie les commandes à exécuter dans le travail en arrière-plan. Pour créer un bloc de script, placez les commandes en accolades ({}). Utilisez la variable automatique $input pour accéder à la valeur du paramètre InputObject. Ce paramètre est requis.

Type:ScriptBlock
Alias:Command
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Type

Spécifie le type personnalisé pour les travaux démarrés par Start-Job. Entrez un nom de type de travail personnalisé, tel que PSScheduledJob pour les travaux planifiés ou PSWorkflowJob pour les travaux de flux de travail. Ce paramètre n’est pas valide pour les travaux en arrière-plan standard.

Ce paramètre a été introduit dans PowerShell 3.0.

Type:String
Position:2
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WorkingDirectory

Spécifie le répertoire de travail initial du travail en arrière-plan. Si le paramètre n’est pas spécifié, le travail s’exécute à partir de l’emplacement par défaut. L’emplacement par défaut est le répertoire de travail actuel de l’appelant qui a démarré le travail.

Ce paramètre a été introduit dans PowerShell 7.

Type:String
Position:Named
Valeur par défaut:$HOME on Unix (macOS, Linux) and $HOME\Documents on Windows
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

String

Vous pouvez diriger un objet avec la propriété Name vers le paramètre Name vers cette applet de commande. Par exemple, vous pouvez diriger un objet FileInfo à partir de Get-ChildItem.

Sorties

System.Management.Automation.PSRemotingJob

Cette applet de commande retourne un objet PSRemotingJob représentant le travail qu’il a démarré.

Notes

PowerShell inclut les alias suivants pour Start-Job:

  • Toutes les plateformes :
    • sajb

Pour s’exécuter en arrière-plan, Start-Job s’exécute dans sa propre session dans la session active. Lorsque vous utilisez l’applet de commande Invoke-Command pour exécuter une commande Start-Job dans une session sur un ordinateur distant, Start-Job s’exécute dans une session dans la session à distance.