Crée une instance de tâche planifiée.
Syntaxe
New-ScheduledTask <CimInstance>] <String>] <CimInstance>] <CimInstance>] <CimInstance>] >] Description
Le cmdlet New-ScheduledTask crée un objet qui contient la définition d’une tâche planifiée.New-ScheduledTask n’enregistre pas automatiquement l’objet avec le service Task Scheduler.
Vous pouvez enregistrer une tâche pour exécuter l’un des types d’applications ou de fichiers suivants : Applications Win32, applications Win16, applications OS/2, applications MS-DOS, fichiers batch (.bat), fichiers de commande (.cmd), ou tout type de fichier correctement enregistré.
Exemples
Exemple 1 : Définir une tâche planifiée et l’enregistrer ultérieurement
PS C:\> $A = New-ScheduledTaskAction -Execute "Taskmgr.exe"PS C:\> $T = New-ScheduledTaskTrigger -AtLogonPS C:\> $P = New-ScheduledTaskPrincipal "Contoso\Administrator"PS C:\> $S = New-ScheduledTaskSettingsSetPS C:\> $D = New-ScheduledTask -Action $A -Principal $P -Trigger $T -Settings $SPS C:\> Register-ScheduledTask T1 -InputObject $DDans cet exemple, l’ensemble de commandes utilise plusieurs cmdlets et variables pour définir puis enregistrer une tâche planifiée.
La première commande utilise le cmdlet New-ScheduledTaskAction pour affecter le fichier exécutable tskmgr.exe à la variable $A.
La deuxième commande utilise le cmdlet New-ScheduledTaskTrigger pour affecter la valeur AtLogon à la variable $T.
La troisième commande affecte le principal de la tâche planifiée Contoso\Administrator à la variable $P.
La quatrième commande utilise le cmdlet New-ScheduledTaskSettingsSet pour affecter un objet de paramètres de tâche à la variable $S.
La cinquième commande crée une nouvelle tâche et affecte la définition de la tâche à la variable $D.
La sixième commande (hypothétiquement) s’exécute à un moment ultérieur.Elle enregistre la nouvelle tâche planifiée et la définit en utilisant la variable $D.
Paramètres
Spécifie un tableau d’éléments de travail pour une tâche à exécuter.Lorsque vous spécifiez plusieurs actions, elles s’exécutent séquentiellement.Une tâche peut avoir jusqu’à 32 actions.
| Type: | CimInstance |
| Position: | 0 |
| Valeur par défaut: | None |
| Accepter l’entrée du pipeline : | False |
| Accepter les caractères génériques : | False |
Exécute la cmdlet en tant que travail en arrière-plan. Utilisez ce paramètre pour exécuter des commandes qui prennent beaucoup de temps à se terminer.
| Type: | Paramètre de commutation |
| Position: | Nommé |
| Valeur par défaut: | None |
| Accepter l’entrée du pipeline : | False |
| Accepter les caractères génériques : | False |
Exécute la cmdlet dans une session distante ou sur un ordinateur distant.Saisissez un nom d’ordinateur ou un objet de session, tel que la sortie d’une cmdlet New-CimSession ou Get-CimSession.La valeur par défaut est la session actuelle sur l’ordinateur local.
| Type: | CimSession |
| Alias: | Session |
| Position: | Nommé |
| Valeur par défaut : | Non |
| Acceptation des entrées du pipeline: | Faux |
| Acceptation des caractères génériques: | Faux |
Décrit brièvement la tâche.
| Type: | String |
| Position: | 4 |
| Valeur par défaut: | None |
| Acceptation de l’entrée du pipeline : | False |
| Accepter les caractères génériques: | False |
Spécifie le contexte de sécurité dans lequel une tâche s’exécute.
| Type: | CimInstance |
| Position: | 3 |
| Valeur par défaut: | None |
| Accepter l’entrée du pipeline : | False |
| Accepter les caractères génériques: | False |
Spécifie un objet de configuration que le service Task Scheduler utilise pour déterminer comment exécuter une tâche.
| Type: | CimInstance |
| Position: | 2 |
| Valeur par défaut: | None |
| Accepter l’entrée du pipeline : | False |
| Accepter les caractères génériques : | False |
Spécifie le nombre maximum d’opérations simultanées qui peuvent être établies pour exécuter le cmdlet.Si ce paramètre est omis ou si une valeur de 0 est saisie, alors Windows PowerShell® calcule une limite d’étranglement optimale pour la cmdlet en fonction du nombre de cmdlets CIM en cours d’exécution sur l’ordinateur.La limite d’étranglement s’applique uniquement à la cmdlet actuelle, et non à la session ou à l’ordinateur.
| Type: | Int32 |
| Position: | Nommé |
| Valeur par défaut: | None |
| Accepter l’entrée du pipeline : | False |
| Accepter les caractères génériques : | False |
Spécifie un tableau d’un ou plusieurs objets déclencheurs qui provoquent le démarrage d’une tâche planifiée.
Un déclencheur est un ensemble de critères qui démarre une tâche planifiée lorsque les critères sont remplis.Vous pouvez utiliser un déclencheur basé sur le temps ou un déclencheur basé sur un événement pour démarrer une tâche, et un ou plusieurs déclencheurs peuvent démarrer une tâche.Une tâche peut avoir jusqu’à 48 déclencheurs.Pour plus d’informations sur les déclencheurs, voir Déclencheurs.
| Type: | CimInstance |
| Position: | 1 |
| Valeur par défaut : | None |
| Acceptation de l’entrée pipeline: | False |
| Acceptation des caractères génériques : | False |
Sorties
CimInstance
- Disable-ScheduledTask
- Enable-ScheduledTask
- Export-ScheduledTask
- Get-ScheduledTask
- New-ScheduledTaskAction
- New-ScheduledTaskSettingsSet
- New-ScheduledTaskPrincipal
- New-ScheduledTaskTrigger
- Register-ScheduledTask
- Set-ScheduledTask
- Start-ScheduledTask
- Stop-ScheduledTask
- Unregister-ScheduledTask