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
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.