Check them out. All three of these resources can help make your life easier and better. Of course, there is the Hey, Scripting Guy! Blog—but hey, you are already here.<\/p>\n
Today I want to talk a bit about troubleshooting scheduled jobs. Here are some things to help you when you have to troubleshoot.<\/p>\n
Import the module <\/h3>\n
To get the results of a Windows PowerShell scheduled job, you use the Get-Job<\/b> cmdlet. But if you use that cmdlet and it shows no results from any scheduled jobs, don’t panic. It probably means that you have not imported the PSScheduledJob module.<\/p>\n
Often I do not need to import it because it automatically loads when I use any cmdlet from the module, such as Get-ScheduledJob<\/b>. But if I open a fresh Windows PowerShell console and immediately type Get-Job<\/b>, I might not see the results I want. So remember, first import the module as shown here (ipmo<\/strong> is an alias for Import-Module<\/strong>):<\/p>\n ipmo PSScheduledJob<\/p>\n If you are not finding the results you seek, it is time to look in the scheduled job Output directory. This is located at the following path:<\/p>\n home\\AppData\\Local\\Microsoft\\Windows\\PowerShell\\ScheduledJob<\/p>\n On my computer, this resolves to the following:<\/p>\n C:\\Users\\ed\\AppData\\Local\\Microsoft\\Windows\\PowerShell\\ScheduledJobs<\/p>\n Under ScheduledJobs, you will find a folder for the scheduled job and an Output folder as shown in the following image:<\/p>\n In the Output folder, there should be a results.xml file and a time-stamped folder for each execution of the scheduled job. If someone clears the job history, these folders are deleted. If there are no folders and XML files in the output directory, the job results cannot be displayed.<\/p>\n To receive the results from a scheduled job (assuming you do not write to an output file or some other file on a disk storage mechanism), you use the Receive-Job<\/b> cmdlet, like for any other Windows PowerShell job.<\/p>\n But if you use Receive-Job<\/b> and nothing comes back, it is possible that you have (or someone else has) already used Receive-Job<\/b> to receive the output, and the –Keep <\/b>parameter was not used. As a best practice, I always use –Keep<\/b> with Receive-Job<\/b> to keep myself from inadvertently deleting the job output.<\/p>\n If job results are still not forthcoming for a job, it is possible that the number of job instances exceeds the ExecutionHistoryLength<\/b> value for that particular job. The default value for a Windows PowerShell scheduled job is 32. To double-check to see what this value is, you can use the following command:<\/p>\n (Get-ScheduledJob getservice).ExecutionHistoryLength<\/p>\n Note<\/b> Yesterday I talked about setting this value in Advanced PowerShell Scheduled Jobs<\/a>.<\/p>\n The Windows PowerShell scheduled job may have been executed (immediately) by using Start-Job<\/b>. Start-Job<\/b> runs a normal Windows PowerShell background job, and the execution history and results are not stored to a disk.<\/p>\n If a Windows PowerShell scheduled job does not run, it might be disabled. By default, all newly created Windows PowerShell scheduled jobs are enabled. But it might have been created as disabled, or it might have been disabled at a later date.<\/p>\n Use the Get-ScheduledJob<\/b> cmdlet to see if the scheduled job is enabled. The Disable-ScheduledJob<\/b> cmdlet disables a Windows PowerShell scheduled job, and the Enable-ScheduledJob<\/b> cmdlet enables a scheduled job. The following command illustrates enabling a scheduled job:<\/p>\n Get-ScheduledJob | Enable-ScheduledJob<\/p>\n The following image shows checking and enabling a scheduled job:<\/p>\n It is possible that the scheduled job failed. To see if it failed, use the Get-WinEvent<\/b> cmdlet, for example:<\/p>\n Get-WinEvent -LogName Microsoft-Windows-TaskScheduler\/Operational |<\/p>\n Where {$_.Message -like "*fail*"}<\/p>\n Permissions are one common cause for scheduled jobs failing. Scheduled jobs run with the permissions of the user who created the job or the permissions of the user who is specified by the Credential<\/b> parameter in the Register-ScheduledJob<\/b> or Set-ScheduledJob<\/b> command. If that user does not have permissions to run the commands, the job fails.<\/p>\n That is all there is to troubleshooting Windows PowerShell scheduled jobs. Join me tomorrow when I will have a guest post about Best Practices for enterprise Windows PowerShell scripting.<\/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, talks about troubleshooting Windows PowerShell scheduled jobs. Microsoft Scripting Guy, Ed Wilson, is here. This has been an awesome week at TechEd 2014 in Houston. I can avoid the "Houston we have a problem" joke for the simple reason that the Scripting Wife and I are on our way […]<\/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,45],"class_list":["post-1346","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-operating-system","tag-scheduled-tasks","tag-scripting-guy","tag-windows-powershell"],"acf":[],"blog_post_summary":" Summary: Microsoft Scripting Guy, Ed Wilson, talks about troubleshooting Windows PowerShell scheduled jobs. Microsoft Scripting Guy, Ed Wilson, is here. This has been an awesome week at TechEd 2014 in Houston. I can avoid the "Houston we have a problem" joke for the simple reason that the Scripting Wife and I are on our way […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/1346","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=1346"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/1346\/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=1346"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=1346"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=1346"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}Look in the scheduled job Output directory <\/h3>\n
![\"Image](\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/29\/2019\/02\/hsg-5-16-14-01.png\" "\\"Image")
<\/a><\/p>\nUse –Keep with Receive-Job <\/h3>\n
Check the ExecutionHistoryLength value<\/h3>\n
Check if Start-Job was used<\/h3>\n
Check if the job is disabled<\/h3>\n
![\"Image](\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/29\/2019\/02\/hsg-5-16-14-02.png\" "\\"Image")
<\/a><\/p>\nCheck if the job failed<\/h3>\n
Check the permissions<\/h3>\n