{"id":14555,"date":"2018-02-27T06:00:18","date_gmt":"2018-02-27T14:00:18","guid":{"rendered":"https:\/\/www.sapien.com\/blog\/?p=14555"},"modified":"2018-07-09T09:01:19","modified_gmt":"2018-07-09T16:01:19","slug":"new-powershell-service-template-for-primalscript-2018","status":"publish","type":"post","link":"https:\/\/dev.sapien.com\/blog\/2018\/02\/27\/new-powershell-service-template-for-primalscript-2018\/","title":{"rendered":"New PowerShell Service Template for PrimalScript 2018"},"content":{"rendered":"

PrimalScript 2018 supports advanced functionality for Windows services written in PowerShell and packaged with PrimalScript 2018 or PowerShell Studio 2018. While your old code will still work unmodified with this packager engine as it detects the presence of the new functions, it is a good idea to revamp your code to use the new template.<\/p>\n

You can find the new template under File<\/em><\/strong>, New<\/strong><\/em>, PowerShell Service<\/em><\/strong> as shown below:<\/p>\n

\"image\"<\/a><\/p>\n

 <\/p>\n

The new template features three preset functions:<\/p>\n\n\n\n\n\n
Start-MyService<\/strong><\/td>\nThis function is called when your service starts. You should place all initialization code for your service here.<\/td>\n<\/tr>\n
Invoke-Myservice<\/strong><\/td>\nThis is your service\u2019s main loop. Take a minute to look at the template to understand the process \u2013 sleep \u2013 process cycle as your service executes.<\/td>\n<\/tr>\n
Stop-MyService<\/strong><\/td>\nThis function is called when your service is asked to stop by the operating system or when using Stop-Service. You can see some management code in here that will allow your main service loop to exit gracefully. Place code to close connections and release resources here.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

 <\/p>\n

Please do<\/strong> not<\/strong> rename these functions. You can add your own functions as you see fit, but these three functions and their names are essential to make your service execute properly once packaged.<\/p>\n

\"image\"<\/a><\/p>\n

 <\/p>\n

Please note that the main service thread is forcefully terminated after you exit the Stop-MyService<\/strong> function. Make sure you terminate running jobs and secondary runspaces here; otherwise the service process may hang and not exit properly.
\nAs some modules create their own threads, jobs, runspaces, etc. it is also a good idea to use remove-module for any modules you load implicitly or explicitly. The script itself does not operate as a service, but you could dot source it from a test script to execute the functions for testing.<\/p>\n

Ultimately, to make a real Windows service, you need to package your script with a PowerShell Windows Service engine as shown here:<\/p>\n

\"image\"<\/a><\/p>\n

 <\/p>\n

As illustrated in a previous blog article<\/a>, the <service>.exe \/i<\/strong> and <service>.exe \/u<\/strong> command line parameters can be used to self-install \/ uninstall the service on your machine.<\/p>\n

View this article<\/a> for information on using the\u00a0Pause<\/em> and\u00a0Continue<\/em> events.<\/p>\n

Feedback<\/h3>\n

If you have any questions, concerns or feedback you are, as always, more than welcome to visit our support forum<\/a>\u00a0and post a message in the appropriate section.<\/p>\n","protected":false},"excerpt":{"rendered":"

PrimalScript 2018 supports advanced functionality for Windows services written in PowerShell and packaged with PrimalScript 2018 or PowerShell Studio 2018. While your old code will still work unmodified with this packager engine as it detects the presence of the new functions, it is a good idea to revamp your code to use the new template. […]<\/p>\n","protected":false},"author":5,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"om_disable_all_campaigns":false,"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"categories":[703,410,1055,21,25],"tags":[437,28,1016,37,300,1032,997],"class_list":["post-14555","post","type-post","status-publish","format-standard","hentry","category-powershell-studio","category-primalscript-software-news","category-scripting","category-software-news","category-windows-powershell","tag-packager","tag-powershell","tag-powershell-studio","tag-primalscript","tag-service","tag-template","tag-windows-powershell"],"aioseo_notices":[],"aioseo_head":"\n\t\t\n\t\n\t\n\t\n\t\n\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t