{"id":10264,"date":"2015-11-10T08:00:05","date_gmt":"2015-11-10T16:00:05","guid":{"rendered":"https:\/\/www.sapien.com\/blog\/?p=10264"},"modified":"2015-11-10T08:32:07","modified_gmt":"2015-11-10T16:32:07","slug":"powershell-studio-2015-service-release-v4-2-96","status":"publish","type":"post","link":"https:\/\/dev.sapien.com\/blog\/2015\/11\/10\/powershell-studio-2015-service-release-v4-2-96\/","title":{"rendered":"PowerShell Studio 2015: Service Release v4.2.96"},"content":{"rendered":"

We released a new service build for PowerShell Studio 2015 (v4.2.96).<\/p>\n

 <\/p>\n

In this release we introduced another new feature:<\/p>\n

 <\/p>\n

Create Module from Help<\/strong><\/p>\n

If you aren\u2019t familiar with PowerShell HelpWriter, it is a tool that lets you create external PowerShell help files (MAML) for existing modules or from scratch. PowerShell HelpWriter can be a useful design tool for creating modules, by allowing you to plan out your module\u2019s cmdlets and its parameter sets before writing a single line of PowerShell code.<\/p>\n

This write-help-first design approach is made much easier with PowerShell Studio\u2019s Create Module from Help File<\/em> feature.<\/p>\n

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

Create a new project and select the help file and give your module a name:<\/p>\n

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

Now you have a new module containing the help file and the skeleton functions defined in the help file.<\/p>\n

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

 <\/p>\n

Build Button for Module Projects<\/strong><\/p>\n

We added a build button to the Project Panel for module projects.<\/p>\n

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

The build button will build the module and export the module to:<\/p>\n

My Documents\\WindowsPowerShell\\Modules<\/p>\n

 <\/p>\n

Improved Syntax Coloring for Classes<\/strong><\/p>\n

We improved syntax coloring for classes. Enumerator and class types are now colored.<\/p>\n

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

Support for New Operator<\/strong><\/p>\n

We also added PrimalSense support for .NET types and the New operator that was introduced in PowerShell V5.<\/p>\n

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

Improved Theme<\/strong><\/p>\n

We improved the theme coloring of the panels and buttons (especially for those who like the dark theme):<\/p>\n

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

 <\/p>\n

Packager Engine Parameters Update<\/strong><\/p>\n

We made some changes to the packager engines so that it is easier for you to handle parameters. Now when you have a parameter block in your script, you can pass named parameters to the executable and it will pass the values to the script for you.<\/p>\n

For example, if your script has a parameter block such as:<\/p>\n

  param<\/span>(<\/span>$param1<\/span> =<\/span> 'default'<\/span>, <\/span>[<\/span>int<\/span>]<\/span>$param2<\/span>, <\/span>[<\/span>int<\/span>]<\/span>$param3<\/span>)<\/span><\/pre>\n
You can call the packaged executable using named parameters:<\/p>\n
  packaged.exe<\/span> \u2013Param1<\/span> \"value 1\"<\/span> \u2013Param2<\/span> 2 \u2013Param3<\/span> 1<\/span><\/span><\/pre>\n
Now there are a few caveats:<\/p>\n
1. Arguments\/ Parameters passed to the executable are going to be strings and not the original objects. Luckily PowerShell can convert strings to integers and other types behind the curtains.<\/p>\n
2. You can\u2019t pass an array of values:<\/p>\n
       -Param1<\/span> 1<\/span>, <\/span>2<\/span>, <\/span>3<\/span><\/pre>\n
Instead you will have to convert it to a string and process the values in your script.<\/p>\n
       -Param1<\/span> \"1, 2, 3\"<\/span><\/pre>\n
Then to have to split the value:<\/p>\n
       $param1<\/span> \u2013split<\/span> ','<\/span><\/pre>\n
3. You can\u2019t use switch or Boolean parameters. Instead you will have to use a parameter of type int<\/em> or string<\/em> and check for specific values<\/p>\n
 <\/p>\n
We also added a new variable $EngineArgs<\/span> (string[]<\/em>) which contains the arguments passed to the executable.<\/p>\n
For example, if you pass the following arguments to the packaged executable:<\/p>\n
  packaged.exe<\/span> \u2013Param1<\/span> value1<\/span> \u2013Param2<\/span> \"value 2\"<\/span> \u2013Param3<\/span> 1<\/span><\/pre>\n
The $EngineArgs<\/span> variable will contain:<\/p>\n
-Param1
value1
-Param2
value 2
-Param3
1<\/p>\n
You can use the $EngineArgs<\/span> variable if you wish to process the packager arguments manually. The $EngineArgs<\/span> variable makes for a better alternative than using the $Commandline<\/span> variable, which you would have to parse from scratch.<\/p>\n
In an upcoming article we will cover using parameters in packaged executables in more detail.<\/p>\n
 <\/p>\n
 <\/p>\n
UPDATE: v4.2.97 Corrects a coloring issue with the designer.<\/em><\/p>\n","protected":false},"excerpt":{"rendered":"
We released a new service build for PowerShell Studio 2015 (v4.2.96).   In this release we introduced another new feature:   Create Module from Help If you aren\u2019t familiar with PowerShell HelpWriter, it is a tool that lets you create external PowerShell help files (MAML) for existing modules or from scratch. PowerShell HelpWriter can be […]<\/p>\n","protected":false},"author":10,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"categories":[703,624,21,25],"tags":[28,951,645,155],"class_list":["post-10264","post","type-post","status-publish","format-standard","hentry","category-powershell-studio","category-service-build","category-software-news","category-windows-powershell","tag-powershell","tag-powershell-studio-2015","tag-service-build-2","tag-service-release"],"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts\/10264","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/users\/10"}],"replies":[{"embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/comments?post=10264"}],"version-history":[{"count":6,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts\/10264\/revisions"}],"predecessor-version":[{"id":10294,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts\/10264\/revisions\/10294"}],"wp:attachment":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/media?parent=10264"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/categories?post=10264"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/tags?post=10264"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
Please continue providing your feedback. Many of the new features included in the service builds are suggestions from users like you. Therefore if you have any suggestions or feature requests, please share them with us on our Wish List and Feature Requests<\/a> forum.<\/p>\n