Whatever code you put in between will be collapsed.<\/p>\n
But, you can make your regions descriptive by adding text after the key word region.<\/p>\n When you collapse the region, you can still see the description. Because I like to use regions, I put together a simple function you can use in the PowerShell ISE to automate the process.<\/p>\n I also defined an alias to make it even easier. Once loaded in the ISE, assuming my cursor is in position for where I want to add the region I can type this command:<\/p>\n And get this result:<\/p>\n Eventually I will roll this into my ISE ScriptingGeek project. But for now, you can add it to the ISE Add-Ons menu with code like this:<\/p>\n I added an extra bit of code so that you can get a GUI prompt so that when you click to insert a region:<\/p>\n If you click Cancel or don't enter anything, you'll still get a region but without any description.<\/p>\n You could use this tool at the start of a new project by going through and outlining what you need to accomplish with regions. When finished, your code is organized and even partially documented.<\/p>\n Enjoy!<\/p>\n","protected":false},"excerpt":{"rendered":" Whenever I teach PowerShell and we get to talking about the PowerShell ISE, I encourage people to get in the habits of using regions. A region can help you organize your code and hide it when you don’t need the distraction. I think regions are especially helpful if you are creating a module file with…<\/p>\n","protected":false},"author":1,"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,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"New from the blog: Regions Rule the #PowerShell ISE","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":true,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2}},"categories":[231],"tags":[567,540],"class_list":["post-4651","post","type-post","status-publish","format-standard","hentry","category-powershell-ise","tag-powershell-ise","tag-scripting"],"yoast_head":"\n![\"An](\"http:\/\/jdhitsolutions.com\/blog\/wp-content\/uploads\/2015\/12\/120715_1415_RegionsRule1.png\")
An expanded region (Image Credit: Jeff Hicks)\/em><\/em><\/span><\/p>\n![\"A](\"http:\/\/jdhitsolutions.com\/blog\/wp-content\/uploads\/2015\/12\/120715_1415_RegionsRule2.png\")
\nA collapsed region (Image Credit: Jeff Hicks)<\/em><\/span><\/p>\n![\"Adding](\"http:\/\/jdhitsolutions.com\/blog\/wp-content\/uploads\/2015\/12\/120715_1415_RegionsRule3.png\")
Adding a region description (Image Credit: Jeff Hicks)<\/em><\/span><\/p>\nFunction New-ISERegion {\r\n[cmdletbinding()]\r\nParam(\r\n[Parameter(Position = 0,HelpMessage = \"Enter text for the region\")]\r\n[string]$Text\r\n)\r\n\r\n$newRegion = @\"\r\n\r\n#region $Text\r\n\r\n\r\n#endregion\r\n\r\n\"@\r\n\r\n#insert into the current file\r\n\r\n$psise.CurrentFile.Editor.InsertText($NewRegion)\r\n\r\n} #end New-ISERegion\r\n\r\nSet-Alias -Name nr -Value New-ISERegion\r\n<\/pre>\n![\"Creating](\"http:\/\/jdhitsolutions.com\/blog\/wp-content\/uploads\/2015\/12\/120715_1415_RegionsRule4.png\")
\nCreating a new region (Image Credit: Jeff Hicks)<\/em><\/span><\/p>\n![\"The](\"http:\/\/jdhitsolutions.com\/blog\/wp-content\/uploads\/2015\/12\/120715_1415_RegionsRule5.png\")
\nThe new region (Image Credit: Jeff Hicks)<\/em><\/span><\/p>\n$action = {\r\nAdd-Type -AssemblyName \"microsoft.visualbasic\"\r\n$mytext = [Microsoft.VisualBasic.Interaction]::InputBox(\"Enter a region description\",\"New Region\")\r\nNew-ISERegion $mytext\r\n}\r\n\r\n$psise.CurrentPowerShellTab.AddOnsMenu.Submenus.Add(\"Insert a region\",$action,$null)\r\n<\/pre>\n![\"The](\"http:\/\/jdhitsolutions.com\/blog\/wp-content\/uploads\/2015\/12\/120715_1415_RegionsRule6.png\")
\nThe new add-on (Image Credit: Jeff Hicks)<\/em><\/span><\/p>\n![\"The](\"http:\/\/jdhitsolutions.com\/blog\/wp-content\/uploads\/2015\/12\/120715_1415_RegionsRule7.png\")
\nThe description prompt (Image Credit: Jeff Hicks)<\/em><\/span><\/p>\n![\"The](\"http:\/\/jdhitsolutions.com\/blog\/wp-content\/uploads\/2015\/12\/120715_1415_RegionsRule8.png\")
\nThe new region (Image Credit: Jeff Hicks)<\/em><\/span><\/p>\n