Get-Job
Obtient les travaux en arrière-plan PowerShell qui s’exécutent dans la session active.
Syntax
Get-Job
[-IncludeChildJob]
[-ChildJobState <JobState>]
[-HasMoreData <Boolean>]
[-Before <DateTime>]
[-After <DateTime>]
[-Newest <Int32>]
[[-Id] <Int32[]>]
[<CommonParameters>]Get-Job
[-IncludeChildJob]
[-ChildJobState <JobState>]
[-HasMoreData <Boolean>]
[-Before <DateTime>]
[-After <DateTime>]
[-Newest <Int32>]
[-InstanceId] <Guid[]>
[<CommonParameters>]Get-Job
[-IncludeChildJob]
[-ChildJobState <JobState>]
[-HasMoreData <Boolean>]
[-Before <DateTime>]
[-After <DateTime>]
[-Newest <Int32>]
[-Name] <String[]>
[<CommonParameters>]Get-Job
[-IncludeChildJob]
[-ChildJobState <JobState>]
[-HasMoreData <Boolean>]
[-Before <DateTime>]
[-After <DateTime>]
[-Newest <Int32>]
[-State] <JobState>
[<CommonParameters>]Get-Job
[-IncludeChildJob]
[-ChildJobState <JobState>]
[-HasMoreData <Boolean>]
[-Before <DateTime>]
[-After <DateTime>]
[-Newest <Int32>]
[-Command <String[]>]
[<CommonParameters>]Get-Job
[-Filter] <Hashtable>
[<CommonParameters>]Description
L’applet Get-Job de commande obtient des objets qui représentent les travaux en arrière-plan démarrés dans la session active. Vous pouvez utiliser Get-Job pour obtenir des travaux démarrés à l’aide de l’applet Start-Job de commande ou en utilisant le paramètre AsJob de n’importe quelle applet de commande.
Sans paramètres, une Get-Job commande obtient tous les travaux de la session active. Vous pouvez utiliser les paramètres de l’obtention de Get-Job travaux particuliers.
L’objet de travail qui Get-Job retourne contient des informations utiles sur le travail, mais il ne contient pas les résultats du travail. Pour obtenir les résultats, utilisez l’applet Receive-Job de commande.
Un travail en arrière-plan Windows PowerShell est une commande qui s’exécute en arrière-plan sans interagir avec la session active. En règle générale, vous utilisez un travail en arrière-plan pour exécuter une commande complexe qui prend beaucoup de temps. Pour plus d'informations sur les tâches en arrière-plan, consultez about_Jobs.
À compter de Windows PowerShell 3.0, l’applet Get-Job de commande obtient également des types de travaux personnalisés, tels que des travaux de flux de travail et des instances de travaux planifiés. Pour rechercher le type d'une tâche, utilisez la propriété PSJobTypeName de la tâche.
Pour activer Get-Job l’obtention d’un type de travail personnalisé, importez le module qui prend en charge le type de travail personnalisé dans la session avant d’exécuter une Get-Job commande, soit à l’aide de l’applet Import-Module de commande, soit en utilisant ou en obtenant une applet de commande dans le module. Pour plus d'informations sur un type de tâche personnalisé particulier, consultez la documentation sur la fonctionnalité de type de tâche personnalisé.
Exemples
Exemple 1 : Prise en main de tous les travaux en arrière-plan dans la session active
Cette commande obtient toutes les tâches en arrière-plan démarrées dans la session active. Elle n'inclut pas les tâches créées dans d'autres sessions, même si elles s'exécutent sur l'ordinateur local.
PS C:\> Get-JobExemple 2 : Arrêter un travail à l’aide d’un ID d’instance
Ces commandes indiquent comment obtenir l'ID d'instance d'une tâche, puis l'utiliser pour arrêter une tâche. Contrairement au nom de la tâche, qui n'est pas unique, l'ID d'instance est unique.
La première commande utilise l’applet Get-Job de commande pour obtenir un travail. Il utilise le paramètre Name pour identifier le travail. La commande stocke l’objet de travail qui Get-Job retourne dans la $j variable. Dans cet exemple, il existe une seule tâche ayant le nom spécifié. La deuxième commande obtient la propriété InstanceId de l’objet dans la $j variable et la stocke dans la $ID variable. La troisième commande affiche la valeur de la $ID variable. La quatrième commande utilise Stop-Job l’applet de commande pour arrêter le travail.
Il utilise le paramètre InstanceId pour identifier le travail et $ID la variable pour représenter l’ID d’instance du travail.
PS C:\> $j = Get-Job -Name Job1
PS C:\> $ID = $j.InstanceID
PS C:\> $ID
Guid
----
03c3232e-1d23-453b-a6f4-ed73c9e29d55
PS C:\> Stop-Job -InstanceId $IDExemple 3 : Obtenir des travaux qui incluent une commande spécifique
Cette commande obtient les travaux sur le système qui incluent une Get-Process commande. La commande utilise le paramètre De commande pour Get-Job limiter les travaux récupérés. La commande utilise des caractères génériques (*) pour obtenir des travaux qui incluent une Get-Process commande n’importe où dans la chaîne de commande.
PS C:\> Get-Job -Command "*get-process*"Exemple 4 : Obtenir des travaux qui incluent une commande spécifique à l’aide du pipeline
Comme la commande dans l’exemple précédent, cette commande obtient les travaux sur le système qui incluent une Get-Process commande. La commande utilise un opérateur de pipeline (|) pour envoyer une chaîne, entre guillemets, à l’applet de Get-Job commande. Elle est équivalente à la commande précédente.
PS C:\> "*get-process*" | Get-JobExemple 5 : Obtenir des travaux qui n’ont pas été démarrés
Cette commande obtient uniquement les tâches qui ont été créées mais qui n'ont pas encore démarré. Cela inclut les tâches dont l'exécution est planifiée ultérieurement et celles qui ne sont pas encore planifiées.
PS C:\> Get-Job -State NotStartedExemple 6 : Obtenir des travaux qui n’ont pas été affectés à un nom
Cette commande obtient tous les travaux qui ont des noms de travaux qui commencent par le travail. Étant donné qu’il job<number> s’agit du nom par défaut d’un travail, cette commande obtient tous les travaux qui n’ont pas de nom attribué explicitement.
PS C:\> Get-Job -Name Job*Exemple 7 : Utiliser un objet de travail pour représenter le travail dans une commande
Cet exemple montre comment utiliser Get-Job pour obtenir un objet de travail, puis comment utiliser l’objet de travail pour représenter le travail dans une commande.
La première commande utilise l’applet Start-Job de commande pour démarrer un travail en arrière-plan qui exécute une Get-Process commande sur l’ordinateur local. La commande utilise le paramètre Name de Start-Job l’affectation d’un nom convivial au travail. La deuxième commande utilise Get-Job pour obtenir le travail. Il utilise le paramètre Name de Get-Job l’identification du travail. La commande enregistre l’objet de travail résultant dans la $j variable. La troisième commande affiche la valeur de l’objet de travail dans la $j variable. La valeur de la propriété State indique que le travail est terminé. La valeur de la propriété HasMoreData indique que des résultats de la tâche sont disponibles, mais qu'ils n'ont pas encore été récupérés. La quatrième commande utilise l’applet Receive-Job de commande pour obtenir les résultats du travail. Il utilise l’objet de travail dans la $j variable pour représenter le travail. Vous pouvez également utiliser un opérateur de pipeline pour envoyer un objet de travail à Receive-Job.
PS C:\> Start-Job -ScriptBlock {Get-Process} -Name MyJob
PS C:\> $j = Get-Job -Name MyJob
PS C:\> $j
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
6 MyJob BackgroundJob Completed True localhost Get-Process
PS C:\> Receive-Job -Job $j
Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName
------- ------ ----- ----- ----- ------ -- -----------
124 4 13572 12080 59 1140 audiodg
783 16 11428 13636 100 548 CcmExec
96 4 4252 3764 59 3856 ccmsetup
...Exemple 8 : Obtenir tous les travaux, y compris les travaux démarrés par une autre méthode
Cet exemple montre que l’applet Get-Job de commande peut obtenir tous les travaux démarrés dans la session actuelle, même s’ils ont été démarrés à l’aide de différentes méthodes.
La première commande utilise l’applet Start-Job de commande pour démarrer un travail sur l’ordinateur local. La deuxième commande utilise le paramètre AsJob de l’applet de commande pour démarrer un travail sur l’ordinateur Invoke-Command S1. Bien que les commandes de la tâche s'exécutent sur l'ordinateur distant, l'objet de traitement est créé sur l'ordinateur local, vous utilisez donc les commandes locales pour gérer la tâche. La troisième commande utilise l’applet Invoke-Command de commande pour exécuter une Start-Job commande sur l’ordinateur S2. À l’aide de cette méthode, l’objet de travail est créé sur l’ordinateur distant, de sorte que vous utilisez des commandes distantes pour gérer le travail. La quatrième commande utilise Get-Job pour obtenir les travaux stockés sur l’ordinateur local. La propriété PSJobTypeName des travaux, introduite dans Windows PowerShell 3.0, indique que le travail local démarré à l’aide de l’applet Start-Job de commande est un travail en arrière-plan et que le travail démarré dans une session distante à l’aide de l’applet Invoke-Command de commande est un travail distant. La cinquième commande utilise Invoke-Command pour exécuter une Get-Job commande sur l’ordinateur S2. L’exemple de sortie affiche les résultats de la Get-Job commande. Sur l'ordinateur S2, la tâche semble être une tâche locale. Le nom de l’ordinateur est localhost et le type de travail est un travail en arrière-plan. Pour plus d’informations sur l’exécution de travaux en arrière-plan sur des ordinateurs distants, consultez about_Remote_Jobs.
PS C:\> Start-Job -ScriptBlock {Get-EventLog System}
PS C:\> Invoke-Command -ComputerName S1 -ScriptBlock {Get-EventLog System} -AsJob
PS C:\> Invoke-Command -ComputerName S2 -ScriptBlock {Start-Job -ScriptBlock {Get-EventLog System}}
PS C:\> Get-Job
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
1 Job1 BackgroundJob Running True localhost Get-EventLog System
2 Job2 RemoteJob Running True S1 Get-EventLog System
PS C:\> Invoke-Command -ComputerName S2 -ScriptBlock {Start-Job -ScriptBlock {Get-EventLog System}}
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- ------- -------
4 Job4 BackgroundJob Running True localhost Get-Eventlog SystemExemple 9 : Examiner un travail ayant échoué
Cette commande montre comment utiliser l’objet de travail qui Get-Job retourne pour examiner pourquoi un travail a échoué.
Elle illustre également comment obtenir les tâches enfant de chaque tâche.
La première commande utilise l’applet Start-Job de commande pour démarrer un travail sur l’ordinateur local. L’objet de travail qui Start-Job retourne montre que le travail a échoué. La valeur de la propriété State a échoué.
La deuxième commande utilise l’applet Get-Job de commande pour obtenir le travail. La commande utilise la méthode du point pour obtenir la valeur de la propriété JobStateInfo de l'objet. Il utilise un opérateur de pipeline pour envoyer l’objet dans la propriété JobStateInfo à l’applet Format-List de commande, qui met en forme toutes les propriétés de l’objet (*) dans une liste. Le résultat de la Format-List commande indique que la valeur de la propriété Reason du travail est vide.
La troisième commande examine plus. Il utilise une Get-Job commande pour obtenir le travail, puis utilise un opérateur de pipeline pour envoyer l’objet de travail entier à l’applet Format-List de commande, qui affiche toutes les propriétés du travail dans une liste. L’affichage de toutes les propriétés de l’objet de travail indique que le travail contient un travail enfant nommé Job2.
La quatrième commande utilise Get-Job pour obtenir l’objet de travail qui représente le travail enfant Job2. Il s'agit de la tâche dans laquelle a été exécutée la commande. Il utilise la méthode dot pour obtenir la propriété Reason de la propriété JobStateInfo . Le résultat montre que le travail a échoué en raison d’une erreur d’accès refusé. Dans ce cas, l’utilisateur a oublié d’utiliser l’option Exécuter en tant qu’administrateur lors du démarrage de Windows PowerShell. Étant donné que les travaux en arrière-plan utilisent les fonctionnalités de communication à distance de Windows PowerShell, l’ordinateur doit être configuré pour exécuter un travail, même lorsque le travail s’exécute sur l’ordinateur local. Pour plus d’informations sur les conditions requises pour la communication à distance dans Windows PowerShell, consultez about_Remote_Requirements. Pour des conseils sur la résolution des problèmes, consultez about_Remote_Troubleshooting.
PS C:\> Start-Job -ScriptBlock {Get-Process}
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
1 Job1 BackgroundJob Failed False localhost Get-Process
PS C:\> (Get-Job).JobStateInfo | Format-List -Property *
State : Failed
Reason :
PS C:\> Get-Job | Format-List -Property *
HasMoreData : False
StatusMessage :
Location : localhost
Command : get-process
JobStateInfo : Failed
Finished : System.Threading.ManualReset
EventInstanceId : fb792295-1318-4f5d-8ac8-8a89c5261507
Id : 1
Name : Job1
ChildJobs : {Job2}
Output : {}
Error : {}
Progress : {}
Verbose : {}
Debug : {}
Warning : {}
StateChanged :
PS C:\> (Get-Job -Name job2).JobStateInfo.Reason
Connecting to remote server using WSManCreateShellEx api failed. The async callback gave the
following error message: Access is denied.Exemple 10 : Obtenir les résultats filtrés
Cet exemple indique comment utiliser le paramètre Filter pour obtenir une tâche de workflow. Le paramètre Filter, introduit dans Windows PowerShell 3.0, n'est valide que sur les types de tâche personnalisé, comme les tâches de workflow et les tâches planifiées.
La première commande utilise le mot clé Workflow pour créer le flux de travail WFProcess. La deuxième commande utilise le paramètre AsJob du flux de travail WFProcess pour exécuter le flux de travail en tant que travail en arrière-plan. Elle utilise le paramètre JobName du workflow pour spécifier un nom pour la tâche et le paramètre PSPrivateMetadata du workflow pour spécifier un ID personnalisé. La troisième commande utilise le paramètre Filter pour Get-Job obtenir le travail par ID personnalisé spécifié dans le paramètre PSPrivateMetadata .
PS C:\> Workflow WFProcess {Get-Process}
PS C:\> WFProcess -AsJob -JobName WFProcessJob -PSPrivateMetadata @{MyCustomId = 92107}
PS C:\> Get-Job -Filter @{MyCustomId = 92107}
Id Name State HasMoreData Location Command
-- ---- ----- ----------- -------- -------
1 WFProcessJob Completed True localhost WFProcessExemple 11 : Obtenir des informations sur les travaux enfants
Cet exemple montre l’effet de l’utilisation des paramètres IncludeChildJob et ChildJobState de l’applet Get-Job de commande.
La première commande obtient les tâches de la session active. La sortie inclut une tâche en arrière-plan, une tâche à distance et plusieurs instances d'une tâche planifiée. La tâche à distance, Job4, semble avoir échoué.
La deuxième commande utilise le paramètre IncludeChildJob de Get-Job. La sortie ajoute les travaux enfants de tous les travaux qui ont des travaux enfants. Dans ce cas, la sortie révisée indique que seul le travail enfant Job5 de Job4 a échoué. La troisième commande utilise le paramètre ChildJobState avec la valeur Failed.La sortie inclut tous les travaux parents et uniquement les travaux enfants ayant échoué. La cinquième commande utilise la propriété JobStateInfo des travaux et sa propriété Reason pour découvrir pourquoi Job5 a échoué.
PS C:\> Get-Job
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
2 Job2 BackgroundJob Completed True localhost .\Get-Archive.ps1
4 Job4 RemoteJob Failed True Server01, Server02 .\Get-Archive.ps1
7 UpdateHelpJob PSScheduledJob Completed True localhost Update-Help
8 UpdateHelpJob PSScheduledJob Completed True localhost Update-Help
9 UpdateHelpJob PSScheduledJob Completed True localhost Update-Help
10 UpdateHelpJob PSScheduledJob Completed True localhost Update-Help
PS C:\> Get-Job -IncludeChildJob
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
2 Job2 BackgroundJob Completed True localhost .\Get-Archive.ps1
3 Job3 Completed True localhost .\Get-Archive.ps1
4 Job4 RemoteJob Failed True Server01, Server02 .\Get-Archive.ps1
5 Job5 Failed False Server01 .\Get-Archive.ps1
6 Job6 Completed True Server02 .\Get-Archive.ps1
7 UpdateHelpJob PSScheduledJob Completed True localhost Update-Help
8 UpdateHelpJob PSScheduledJob Completed True localhost Update-Help
9 UpdateHelpJob PSScheduledJob Completed True localhost Update-Help
10 UpdateHelpJob PSScheduledJob Completed True localhost Update-Help
PS C:\> Get-Job -Name Job4 -ChildJobState Failed
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
2 Job2 BackgroundJob Completed True localhost .\Get-Archive.ps1
4 Job4 RemoteJob Failed True Server01, Server02 .\Get-Archive.ps1
5 Job5 Failed False Server01 .\Get-Archive.ps1
7 UpdateHelpJob PSScheduledJob Completed True localhost Update-Help
8 UpdateHelpJob PSScheduledJob Completed True localhost Update-Help
9 UpdateHelpJob PSScheduledJob Completed True localhost Update-Help
10 UpdateHelpJob PSScheduledJob Completed True localhost Update-Help
PS C:\> (Get-Job -Name Job5).JobStateInfo.Reason
Connecting to remote server Server01 failed with the following error message:
Access is denied.Pour plus d’informations, consultez la rubrique d’aide about_Remote_Troubleshooting .
Paramètres
-After
Obtient les tâches terminées après la date et l'heure spécifiées. Entrez un objet DateTime , tel qu’un retourné par l’applet Get-Date de commande ou une chaîne qui peut être convertie en objet DateTime , tel que Dec 1, 2012 2:00 AM ou 11/06.
Ce paramètre fonctionne uniquement sur les types de tâches personnalisés, comme les tâches de workflow et les tâches planifiées, qui ont une propriété EndTime. Elle ne fonctionne pas sur les travaux en arrière-plan standard, tels que ceux créés à l’aide de l’applet de Start-Job commande. Pour plus d'informations sur la prise en charge de ce paramètre, consultez la rubrique d'aide relative au type de tâche.
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Before
Obtient les tâches terminées avant la date et l'heure spécifiées. Entrez un objet DateTime .
Ce paramètre fonctionne uniquement sur les types de tâches personnalisés, comme les tâches de workflow et les tâches planifiées, qui ont une propriété EndTime. Elle ne fonctionne pas sur les travaux en arrière-plan standard, tels que ceux créés à l’aide de l’applet de Start-Job commande. Pour plus d'informations sur la prise en charge de ce paramètre, consultez la rubrique d'aide relative au type de tâche.
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ChildJobState
Obtient uniquement les tâches enfant dans l'état spécifié. Les valeurs valides pour ce paramètre sont :
- NotStarted
- Exécution en cours
- Completed
- Échec
- Arrêté
- Bloqué
- Interrompu
- Déconnecté
- Suspension
- En cours d’arrêt
Par défaut, Get-Job n’obtient pas de travaux enfants. En utilisant le paramètre IncludeChildJob , Get-Job obtient tous les travaux enfants. Si vous utilisez le paramètre ChildJobState, le paramètre IncludeChildJob n'a aucun effet.
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | JobState |
| Accepted values: | NotStarted, Running, Completed, Failed, Stopped, Blocked, Suspended, Disconnected, Suspending, Stopping, AtBreakpoint |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Command
Spécifie un tableau de commandes sous forme de chaînes. Cette applet de commande obtient les travaux qui incluent les commandes spécifiées. Par défaut, il s'agit de toutes les tâches. Vous pouvez utiliser des caractères génériques pour spécifier un modèle de commande.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | True |
-Filter
Spécifie une table de hachage des conditions. Cette applet de commande obtient des travaux qui répondent à toutes les conditions. Entrez une table de hachage où les clés sont les propriétés des travaux et les valeurs celles des propriétés des travaux.
Ce paramètre fonctionne uniquement sur les types de tâches personnalisées, tels que les tâches de workflow et les tâches planifiées. Elle ne fonctionne pas sur les travaux en arrière-plan standard, tels que ceux créés à l’aide de l’applet de Start-Job commande. Pour plus d'informations sur la prise en charge de ce paramètre, consultez la rubrique d'aide relative au type de tâche.
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | Hashtable |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-HasMoreData
Indique si cette applet de commande obtient uniquement des travaux qui ont la valeur de propriété HasMoreData spécifiée.
La propriété HasMoreData indique si tous les résultats de la tâche ont été reçus dans la session active. Pour obtenir des travaux qui ont plus de résultats, spécifiez une valeur de $True. Pour obtenir des travaux qui n’ont pas plus de résultats, spécifiez une valeur de $False.
Pour obtenir les résultats d’un travail, utilisez l’applet Receive-Job de commande.
Lorsque vous utilisez l’applet Receive-Job de commande, elle supprime de son stockage en mémoire, spécifique à la session, les résultats qu’il a retournés. Lorsqu’il a retourné tous les résultats du travail dans la session active, il définit la valeur de la propriété HasMoreData du travail sur $False) pour indiquer qu’il n’a plus de résultats pour le travail dans la session active. Utilisez le paramètre Keep pour Receive-Job empêcher Receive-Job la suppression des résultats et la modification de la valeur de la propriété HasMoreData .
Pour plus d'informations, voir Get-Help Receive-Job.
La propriété HasMoreData est propre à la session active. Si les résultats d’un type de travail personnalisé sont enregistrés en dehors de la session, comme le type de travail planifié, qui enregistre les résultats du travail sur le disque, vous pouvez utiliser l’applet Receive-Job de commande dans une autre session pour obtenir à nouveau les résultats du travail, même si la valeur de HasMoreData est $False. Pour plus d'informations, consultez les rubriques d'aide du type de tâche personnalisé.
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Id
Spécifie un tableau d’ID de travaux que cette applet de commande obtient.
L’ID est un entier qui identifie de manière unique le travail dans la session active. Il est plus facile de mémoriser et de taper que l’ID d’instance, mais il est unique uniquement dans la session active. Vous pouvez taper un ou plusieurs ID séparés par des virgules. Pour rechercher l’ID d’un travail, tapez Get-Job sans paramètres.
| Type: | Int32[] |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-IncludeChildJob
Indique que cette applet de commande retourne des travaux enfants, en plus des travaux parents.
Ce paramètre est particulièrement utile pour examiner les travaux de flux de travail, pour lesquels Get-Job retourne un travail parent de conteneur et les échecs de travail, car la raison de l’échec est enregistrée dans une propriété du travail enfant.
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InstanceId
Spécifie un tableau d’ID d’instance de travaux que cette applet de commande obtient. Par défaut, il s'agit de toutes les tâches.
Un ID d'instance est un GUID qui identifie de façon unique la tâche sur l'ordinateur. Pour rechercher l’ID d’instance d’un travail, utilisez Get-Job.
| Type: | Guid[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Spécifie un tableau de noms convivial d’instance de travaux que cette applet de commande obtient. Entrez un nom de tâche ou utilisez des caractères génériques pour entrer un modèle de nom de tâche. Par défaut, Get-Job obtient tous les travaux de la session active.
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | True |
-Newest
Spécifie un certain nombre de travaux à obtenir. Cette applet de commande obtient les travaux qui se sont terminés le plus récemment.
Le paramètre Newest ne trie pas ni ne retourne les tâches les plus récentes selon l'heure de fin. Pour trier la sortie, utilisez l’applet de Sort-Object commande.
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-State
Spécifie un état de travail. Cette applet de commande obtient uniquement des travaux dans l’état spécifié. Les valeurs valides pour ce paramètre sont :
- NotStarted
- Exécution en cours
- Completed
- Échec
- Arrêté
- Bloqué
- Interrompu
- Déconnecté
- Suspension
- En cours d’arrêt
Par défaut, Get-Job obtient tous les travaux de la session active.
Pour plus d’informations sur les états du travail, consultez Énumération JobState.
| Type: | JobState |
| Accepted values: | NotStarted, Running, Completed, Failed, Stopped, Blocked, Suspended, Disconnected, Suspending, Stopping, AtBreakpoint |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Entrées
None
Vous ne pouvez pas diriger d'entrée vers cette applet de commande.
Sorties
System.Management.Automation.RemotingJob
Cette applet de commande retourne des objets qui représentent les travaux de la session.
Notes
La propriété PSJobTypeName des tâches indique le type de la tâche. La valeur de propriété est déterminée par l'auteur du type de tâche. La liste suivante affiche les types de tâches courants.
- BackgroundJob. Tâche locale démarrée à l’aide
Start-Jobde . - RemoteJob. Travail démarré dans une session PSSession à l’aide du paramètre AsJob de l’applet
Invoke-Commandde commande. - PSWorkflowJob. tâche démarrée à l'aide du paramètre AsJob commun des workflows.