{"id":7495,"date":"2014-07-09T09:41:00","date_gmt":"2014-07-09T17:41:00","guid":{"rendered":"http:\/\/www.sapien.com\/blog\/?p=7495"},"modified":"2014-07-09T09:42:10","modified_gmt":"2014-07-09T17:42:10","slug":"powershell-studio-2014-convert-functions-into-a-module","status":"publish","type":"post","link":"https:\/\/dev.sapien.com\/blog\/2014\/07\/09\/powershell-studio-2014-convert-functions-into-a-module\/","title":{"rendered":"PowerShell Studio 2014: Convert Functions into a Module"},"content":{"rendered":"

PowerShell Studio 2014 added a new project feature: New Module From Functions<\/em>.<\/p>\n

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

You may find at times you reuse various functions and constantly copy them into new scripts or find different variations of the same function are located in different scripts. You may come to the conclusion that those functions would better serve you in the form of a module where all your scripts can reference the functions in a centralized location. This is where the New Module From Functions<\/em> feature comes in handy.<\/p>\n

The New Module From Functions<\/em> allows you to import functions from various ps1 scripts and merge them into a new script module. When you select this project from the menu it will ask you to select a file (if one not already open) and present you with the following dialog:<\/p>\n

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

Let\u2019s cover each field individually:<\/p>\n

Module Name<\/strong><\/em><\/p>\n

Enter the name you wish to give your new module.<\/p>\n

Location<\/strong><\/em><\/p>\n

Specify the folder where the module will be saved. The default is PowerShell Studio\u2019s project directory.<\/p>\n

Create Module Folder<\/strong><\/em><\/p>\n

This option creates a folder using the module\u2019s name and places all the generated files within that folder. This folder will be created in the folder specified by the Location<\/em> field.<\/p>\n

Source Files<\/strong><\/em><\/p>\n

Contains the list of files from which the selected functions with be extracted.<\/p>\n

Add File<\/em><\/strong><\/p>\n

Use the Add File<\/em> button to add ps1 scripts to the Source Files<\/em>, in order to extract their functions.<\/p>\n

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

Remove File<\/em><\/strong><\/p>\n

Use the Remove File<\/em> button to remove unnecessary files from the Source Files<\/em> list. This can help de-clutter the functions list.<\/p>\n

Functions<\/em><\/strong><\/p>\n

The functions section contains a node for each file and its respective list of functions that are declared in said file.<\/p>\n

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

Use this list to check the functions you wish to import into the new module. If a function references another function, it will have a Referenced Functions<\/em> folder icon below that contains a list of the all the referenced functions.<\/p>\n

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

\"Tip\"
When you check a function in the list that has references, it will automatically check all the referenced functions as well.<\/p>\n

\"Tip\" You can check and un-check all the functions in the file by checking\/un-checking the file\u2019s node.<\/p>\n

 <\/p>\n

Create Module<\/em><\/strong><\/p>\n

Once you have selected the functions and specified a module name you can press the Create Module<\/em> button to generate the new module.<\/p>\n

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

Note on duplicate functions:<\/em>
In some instances you may have a duplicate function that is defined in multiple files. PowerShell Studio will compare these functions and if they are identical, it will only insert the function once. If the functions are different, PowerShell Studio will automatically rename the duplicate. A warning will be displayed in the Output window when this occurs:<\/p>\n

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

 <\/p>\n

The new module project will contain three files:<\/p>\n

Module Name.psd1<\/em> \u2013 Contains the module\u2019s manifest.<\/p>\n

Module Name.psm1<\/em> \u2013 Contains all the imported functions and an Export-ModuleMember cmdlet statement listing all the imported functions.<\/p>\n

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

You can remove any function you do not wish to be exported by the module here.<\/p>\n

Module Name.Help.xml<\/em> \u2013 Contains the PowerShell Xml Help file for the module, generated using the imported functions.<\/p>\n

 <\/p>\n

Now you have a complete PowerShell module with minimal effort on your part.<\/p>\n","protected":false},"excerpt":{"rendered":"

PowerShell Studio 2014 added a new project feature: New Module From Functions. You may find at times you reuse various functions and constantly copy them into new scripts or find different variations of the same function are located in different scripts. You may come to the conclusion that those functions would better serve you in […]<\/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,21,632],"tags":[349,282,753,28,874],"class_list":["post-7495","post","type-post","status-publish","format-standard","hentry","category-powershell-studio","category-software-news","category-whats-new-software-news","tag-convert","tag-functions","tag-module","tag-powershell","tag-powershell-studio-2014"],"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts\/7495","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=7495"}],"version-history":[{"count":10,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts\/7495\/revisions"}],"predecessor-version":[{"id":7507,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts\/7495\/revisions\/7507"}],"wp:attachment":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/media?parent=7495"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/categories?post=7495"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/tags?post=7495"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}