Yesterday I created a Windows PowerShell scheduled job with a time trigger, and it ran successfully. Then, I shut down my laptop. Now, we are back at the hotel, I power up my laptop, and guess what? When I use the Get-ScheduledJob<\/b> cmdlet, I see that the Windows PowerShell scheduled jobs still exist. They are shown here:<\/p>\n
Note <\/b>To use any of the *job<\/b> cmdlets (for example, Get-Job<\/b> or Receive-Job<\/b>), the PSScheduledJob module must load into the current session. This happens when you use a cmdlet such as Get-ScheduledJob<\/b>. You can also specifically import the module by using Import-Module PSScheduledJob<\/b>.<\/p>\n I can also check to see if the job completed and if there is any data left. To do this, I use the Get-Job<\/b> cmdlet. I can then use the name or the job ID. The easiest thing to do is to give the job a decent name, and use the name. This is because the job ID from Get-ScheduledJob<\/b> and the job ID from Get-Job<\/b> are different numbers. When I get the job, I pipe it to the Format-List<\/b> cmdlet as shown here:<\/p>\n One thing that I like to do is see how long the scheduled job takes to run. This is useful to help to develop some sort of a track record for comparison. I can use the New-TimeSpan<\/b> cmdlet and select the PSBeginTime <\/b>and the PSEndTime <\/b>properties to obtain this information. Here is the command I use:<\/p>\n New-TimeSpan -Start (get-job -name gps).psbegintime -End (get-job -name gps).psendtime<\/p>\n The command returns a TimeSpan<\/b> object. I generally simply return the entire object because, at times, I do not know how long the job runs. Pay really close attention when reading the object because the first portion contains the number of days, hours, minutes, seconds, and milliseconds the job takes to complete. I have to add these parts together to get a total time. Or I can go to the Total* section. For example, this job took a total of 2.2812358 seconds.<\/p>\n Days : 0<\/p>\n Hours : 0<\/p>\n Minutes : 0<\/p>\n Seconds : 2<\/p>\n Milliseconds : 281<\/p>\n Ticks : 22812358<\/p>\n TotalDays : 2.64031921296296E-05<\/p>\n TotalHours : 0.000633676611111111<\/p>\n TotalMinutes : 0.0380205966666667<\/p>\n TotalSeconds : 2.2812358<\/p>\n TotalMilliseconds : 2281.2358<\/p>\n Even though I rebooted my computer, I can still look at the job results. This is because I used the –Keep<\/b> parameter when viewing the results. This is shown here:<\/p>\n One of the cool things I can do is run the job directly. This is useful, for example, when I have a scheduled job that was set up to run on a schedule, and I want an impromptu run. A classic illustration of this situation is when I have a scheduled backup that runs each morning, but I have made a significant number of changes to a system (or I am getting ready to make a significant number of changes), and I would like to run an impromptu backup without modifying my regularly scheduled backup.<\/p>\n To run a scheduled job as a one-off, all I need to do is to use the Start-Job<\/b> cmdlet and specify the name of the job as shown here:<\/p>\n PS C:\\> Start-Job -DefinitionName gps<\/p>\n Id Name PSJobTypeName State HasMoreData Location<\/p>\n — —- ————- —– ———– ——–<\/p>\n 5 GPS PSScheduledJob Running True localhost<\/p>\n To remove job triggers, I can use the Remove-JobTrigger<\/b> cmdlet. One way to do this is to remove the job trigger by the name of the trigger itself. To find this, I can use the Get-ScheduledJob<\/b> cmdlet and pipe the results to Get-JobTrigger<\/b>. I can also use the ID of the trigger, or I can pipe a scheduled job definition object to the cmdlet. Here are a couple of examples:<\/p>\n Remove-JobTrigger -Id 1<\/p>\n Get-ScheduledJob | Get-JobTrigger<\/p>\n Keep in mind that the input object is a ScheduledJobDefinition<\/b> object that comes from Get-ScheduledJob<\/b>, and not a ScheduledJobTrigger<\/b> object. Therefore, the following command fails:<\/p>\n To delete Windows PowerShell scheduled jobs, you use the Unregister-ScheduledJob<\/b> cmdlet.<\/p>\n Note <\/b> It is a bit confusing that the PSScheduledJob module uses Register-ScheduledJob<\/b> and Unregister-ScheduledJob<\/b> instead of the New and Remove verbs. But with scheduled jobs, you are actually registering and unregistering, so the verbs make sense from a technical perspective.<\/p>\n If I want to delete all of my Windows PowerShell scheduled jobs, I use the following command:<\/p>\n Get-ScheduledJob | Unregister-ScheduledJob<\/p>\n There you have more info about using Windows PowerShell scheduled jobs. Scheduled Jobs Week will continue tomorrow when I will talk about more cool stuff.<\/p>\n I invite you to follow me on Twitter<\/a> and Facebook<\/a>. If you have any questions, send email to me at scripter@microsoft.com<\/a>, or post your questions on the Official Scripting Guys Forum<\/a>. See you tomorrow. Until then, peace.<\/p>\n Ed Wilson, Microsoft Scripting Guy<\/b> <\/p>\n","protected":false},"excerpt":{"rendered":" Summary: Microsoft Scripting Guy, Ed Wilson, continues his discussion about Windows PowerShell scheduled jobs. Microsoft Scripting Guy, Ed Wilson, is here. Last night was the Expo floor meet-and-greet at TechEd in Houston. It was a crazy time, and we had literally thousands of people stopping by to say "hi," and to meet up with other […]<\/p>\n","protected":false},"author":596,"featured_media":87096,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[31,32,3,4,45],"class_list":["post-1395","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-operating-system","tag-scheduled-tasks","tag-scripting-guy","tag-scripting-techniques","tag-windows-powershell"],"acf":[],"blog_post_summary":" Summary: Microsoft Scripting Guy, Ed Wilson, continues his discussion about Windows PowerShell scheduled jobs. Microsoft Scripting Guy, Ed Wilson, is here. Last night was the Expo floor meet-and-greet at TechEd in Houston. It was a crazy time, and we had literally thousands of people stopping by to say "hi," and to meet up with other […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/1395","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/users\/596"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/comments?post=1395"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/1395\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media\/87096"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media?parent=1395"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=1395"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=1395"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}![\"Image](\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/29\/2019\/02\/hsg-5-13-14-01.png\" "\\"Image")
<\/a><\/p>\n![\"Image](\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/29\/2019\/02\/hsg-5-13-14-02.png\" "\\"Image")
<\/a><\/p>\n![\"Image](\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/29\/2019\/02\/hsg-5-13-14-03.png\" "\\"Image")
<\/a><\/p>\nDeleting stuff<\/h2>\n
![\"Image](\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/29\/2019\/02\/hsg-5-13-14-04.png\" "\\"Image")
<\/a><\/p>\n