PoshCode Archive  Artifact [f345747d43]

Artifact f345747d434e54e0549438a6d41b020d27e63fb36f7573ab232e81d35d72a1a2:

  • File Using-Task-Sch-wrapper.ps1 — part of check-in [50c6aa6458] at 2018-06-10 14:01:42 on branch trunk — Powershell example using Task Scheduler managed wrapper I drafted up some time ago. The task this creates is harmless; it just launches notepad.exe. you can run the code and examine the created task to see what you need to change to create a task that does something useful. (user: BattleChicken size: 2426)

# encoding: ascii
# api: powershell
# title: Using Task Sch, wrapper
# description: Powershell example using Task Scheduler managed wrapper I drafted up some time ago.  The task this creates is harmless; it just launches notepad.exe.  you can run the code and examine the created task to see what you need to change to create a task that does something useful.
# version: 0.1
# type: script
# author: BattleChicken
# license: CC0
# x-poshcode-id: 5805
# x-archived: 2015-04-03T14:46:50
# x-published: 2015-04-01T18:01:00
#
#
#
# Requires the DLL from the taskscheduler managed wrapper
# http://taskscheduler.codeplex.com/releases/view/120747
#
add-type -Path "C:\PathTo\TaskScheduler\Microsoft.Win32.TaskScheduler.dll"

$taskService = New-Object Microsoft.Win32.TaskScheduler.TaskService
$taskDef = $taskService.NewTask()
$taskDef.RegistrationInfo.Description = "TASK THAT I INSTALL ON THE MACHINE"


$timeTrigger = New-Object Microsoft.Win32.TaskScheduler.TimeTrigger
$timeTrigger.StartBoundary = [datetime]::Now + [timespan]::FromHours($hourDelay) #start the task in $hourdelay hours
$timeTrigger.EndBoundary =  [datetime]::Today + [timespan]::FromDays(1000) # delete the task in over 3 years.

$taskDef.Triggers.Add($timeTrigger)

$taskAction = New-Object Microsoft.Win32.TaskScheduler.ExecAction
$taskAction.Path = "C:\windows\notepad.exe"

$taskDef.actions.Add($taskAction)

$taskDef.Data = "This is a value.  For DATA"
$taskDef.Principal.UserId = "SYSTEM"  # THE SYSTEM IS DOWN

$taskDef.Principal.LogonType = [Microsoft.Win32.TaskScheduler.TaskLogonType]::InteractiveToken
$taskDef.RegistrationInfo.Author = "BattleChicken" #This value has to be Battlechicken or your task will crash. Maybe.

$taskDef.Settings.DisallowStartIfOnBatteries = $false;
$taskDef.Settings.Enabled = $true
$taskDef.Settings.Hidden = $false
$taskDef.Settings.Priority = [System.Diagnostics.ProcessPriorityClass]::Normal # you can set process priority
$taskDef.Settings.RunOnlyIfIdle = $false
$taskDef.Settings.RunOnlyIfIdle = $false
$taskDef.Principal.RunLevel = [Microsoft.Win32.TaskScheduler.TaskRunLevel]::Highest # run with highest permissions
$taskDef.Settings.StartWhenAvailable = $true # run if schedule missed.  This won't be respected for a one-time task UNLESS you also set a task expiration date
$taskService.RootFolder.RegisterTaskDefinition("BattleChicken's sweet task", $taskDef)