{"id":586,"date":"2018-06-11T08:00:27","date_gmt":"2018-06-11T14:00:27","guid":{"rendered":"https:\/\/practicalpowershell.com\/?p=586"},"modified":"2020-03-14T16:40:28","modified_gmt":"2020-03-14T22:40:28","slug":"no-commenting-not-in-powershell","status":"publish","type":"post","link":"https:\/\/practicalpowershell.com\/no-commenting-not-in-powershell\/","title":{"rendered":"No Comment(ing)? Not in PowerShell"},"content":{"rendered":"

\"\"<\/a>Writing a script can be hard, making it reusable a bit harder and having someone else understand it’s purpose one of the hardest things you can do. To make your life and their life easier, the use of Comments is an easy way to enhance or augment a script. Below are a few examples of Commenting in PowerShell, the list is not exhaustive, but merely instructive.

\nExamples of Comments<\/u>

\nScript Sections<\/em>

\nOne way to help someone parse a script and its purpose is to label sections of the script – variables, functions, main body, etc. Like so:
\n[sourcecode language=”powershell”]
\n# Variables
\n$NumberOfMailboxes = 0
\n$Failed = $False
\n$UserCount = 0
\n# Email Process
\nSend-MailMessage -To $To -From $From -Subject $Subject -Bodyashtml -Body $Body
\nSMTPServer $SMTPServer -Credential $SMTPCred -Port $Port -UseSsl
\n[\/sourcecode]
\nComments can also be used to provide a detailed description of the script and is usually placed at the beginning of your script:
\n[sourcecode language=”powershell”]
\n##########################################################
\n# SCRIPT DETAILS
\n# This script drives a menu to run Active Directory health check scripts.
\n# #
\n# SCRIPT VERSION HISTORY
\n# Current Version : 1.5
\n# Change Log
\n# :1.5 – fixed bugs, improve reporting
\n# : 1.4 – Added GPO check, fixed DNSLint issues
\n# : 1.3 – Tweaks and bug fixes
\n# : 1.2 – Removed deprecated tools
\n# : 1.1 – Added more AD Information and a fix for remote PS
\n# : 1.0 – First version
\n#
\n# OTHER SCRIPT
\n# Wish list : More tests, change some tests to export to HTML
\n# Rights Required : Enterprise Admin \/ Domain Admin
\n# Author : Damian Scoles
\n# My Blog : http:\/\/justaucguy.wordpress.com
\n#
\n# Disclaimer: You are on your own. This was not written by, supported
\n# by, or endorsed by Microsoft.
\n#
\n# EXECUTION
\n#. \\ActiveDirectoryHealthCheckMenu.PS1
\n#
\n##########################################################
\n[\/sourcecode]
\nComments can also be used to describe a function’s purpose:

\nThis function checks for hotfixes needed in order to install corporate applications
\n[sourcecode language=”powershell”]
\nFunction HotfixCheck {
\n# Check to see if the hot fix is installed
\n$Hotfix = Get-Hotfix | Where {$_.HotFixid -eq "KB3146714"}
\n# If the $Hotfix variable is empty, no hotfix is installed, then install the hotfix
\nIf ($Hotfix -eq $null) {
\n# Set value of command to run to install the KB38146714 hotfix
\n[String]$Expression = "wusa.exe .\\Windows8-RT-KB3146714-x64.msu \/Quiet \/NoRestart"
\n# Runs the install process
\nInvoke-Expression $expression
\n}
\n} # End HotfixCheck Function
\n[\/sourcecode]
\nAs you can see, comments are an easy add to your PowerShell script and can serve many purposes. We write about this in our Exchange 2016 and Exchange Online books, so visit our shop to pick up your own copy for reference today.<\/p>\n","protected":false},"excerpt":{"rendered":"

Writing a script can be hard, making it reusable a bit harder and having someone else understand it’s purpose one of the hardest things you can do. To make your life and their life easier, the use of Comments is an easy way to enhance or augment a script. Below are a few examples of […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"rop_custom_images_group":[],"rop_custom_messages_group":[],"rop_publish_now":"initial","rop_publish_now_accounts":[],"rop_publish_now_history":[],"rop_publish_now_status":"pending","_jetpack_memberships_contains_paid_content":false,"footnotes":""},"categories":[1],"tags":[],"class_list":["post-586","post","type-post","status-publish","format-standard","hentry","category-uncategorized"],"yoast_head":"\nNo Comment(ing)? Not in PowerShell - Practical PowerShell<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/practicalpowershell.com\/no-commenting-not-in-powershell\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"No Comment(ing)? Not in PowerShell - Practical PowerShell\" \/>\n<meta property=\"og:description\" content=\"Writing a script can be hard, making it reusable a bit harder and having someone else understand it’s purpose one of the hardest things you can do. To make your life and their life easier, the use of Comments is an easy way to enhance or augment a script. Below are a few examples of […]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/practicalpowershell.com\/no-commenting-not-in-powershell\/\" \/>\n<meta property=\"og:site_name\" content=\"Practical PowerShell\" \/>\n<meta property=\"article:published_time\" content=\"2018-06-11T14:00:27+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2020-03-14T22:40:28+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/practicalpowershell.com\/wp-content\/uploads\/2020\/03\/Comments-150x150.jpg\" \/>\n<meta name=\"author\" content=\"damian\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"damian\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/practicalpowershell.com\\\/no-commenting-not-in-powershell\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/practicalpowershell.com\\\/no-commenting-not-in-powershell\\\/\"},\"author\":{\"name\":\"damian\",\"@id\":\"https:\\\/\\\/practicalpowershell.com\\\/#\\\/schema\\\/person\\\/4d0733c81966e744aabbb49f56d64deb\"},\"headline\":\"No Comment(ing)? Not in PowerShell\",\"datePublished\":\"2018-06-11T14:00:27+00:00\",\"dateModified\":\"2020-03-14T22:40:28+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/practicalpowershell.com\\\/no-commenting-not-in-powershell\\\/\"},\"wordCount\":401,\"commentCount\":0,\"publisher\":{\"@id\":\"https:\\\/\\\/practicalpowershell.com\\\/#\\\/schema\\\/person\\\/4d0733c81966e744aabbb49f56d64deb\"},\"image\":{\"@id\":\"https:\\\/\\\/practicalpowershell.com\\\/no-commenting-not-in-powershell\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/practicalpowershell.com\\\/wp-content\\\/uploads\\\/2020\\\/03\\\/Comments-150x150.jpg\",\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\\\/\\\/practicalpowershell.com\\\/no-commenting-not-in-powershell\\\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/practicalpowershell.com\\\/no-commenting-not-in-powershell\\\/\",\"url\":\"https:\\\/\\\/practicalpowershell.com\\\/no-commenting-not-in-powershell\\\/\",\"name\":\"No Comment(ing)? Not in PowerShell - Practical PowerShell\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/practicalpowershell.com\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/practicalpowershell.com\\\/no-commenting-not-in-powershell\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/practicalpowershell.com\\\/no-commenting-not-in-powershell\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/practicalpowershell.com\\\/wp-content\\\/uploads\\\/2020\\\/03\\\/Comments-150x150.jpg\",\"datePublished\":\"2018-06-11T14:00:27+00:00\",\"dateModified\":\"2020-03-14T22:40:28+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/practicalpowershell.com\\\/no-commenting-not-in-powershell\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/practicalpowershell.com\\\/no-commenting-not-in-powershell\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/practicalpowershell.com\\\/no-commenting-not-in-powershell\\\/#primaryimage\",\"url\":\"https:\\\/\\\/i0.wp.com\\\/practicalpowershell.com\\\/wp-content\\\/uploads\\\/2020\\\/03\\\/Comments.jpg?fit=526%2C253&ssl=1\",\"contentUrl\":\"https:\\\/\\\/i0.wp.com\\\/practicalpowershell.com\\\/wp-content\\\/uploads\\\/2020\\\/03\\\/Comments.jpg?fit=526%2C253&ssl=1\",\"width\":526,\"height\":253},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/practicalpowershell.com\\\/no-commenting-not-in-powershell\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/practicalpowershell.com\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"No Comment(ing)? Not in PowerShell\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/practicalpowershell.com\\\/#website\",\"url\":\"https:\\\/\\\/practicalpowershell.com\\\/\",\"name\":\"Practical PowerShell\",\"description\":\"PowerShell books written by experts\",\"publisher\":{\"@id\":\"https:\\\/\\\/practicalpowershell.com\\\/#\\\/schema\\\/person\\\/4d0733c81966e744aabbb49f56d64deb\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/practicalpowershell.com\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":[\"Person\",\"Organization\"],\"@id\":\"https:\\\/\\\/practicalpowershell.com\\\/#\\\/schema\\\/person\\\/4d0733c81966e744aabbb49f56d64deb\",\"name\":\"damian\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/d5a8cc64a5aa27558a897b108e3be1a89859511a3fd26176dac292f26e7a4ae4?s=96&d=mm&r=g\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/d5a8cc64a5aa27558a897b108e3be1a89859511a3fd26176dac292f26e7a4ae4?s=96&d=mm&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/d5a8cc64a5aa27558a897b108e3be1a89859511a3fd26176dac292f26e7a4ae4?s=96&d=mm&r=g\",\"caption\":\"damian\"},\"logo\":{\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/d5a8cc64a5aa27558a897b108e3be1a89859511a3fd26176dac292f26e7a4ae4?s=96&d=mm&r=g\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"No Comment(ing)? Not in PowerShell - Practical PowerShell","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/practicalpowershell.com\/no-commenting-not-in-powershell\/","og_locale":"en_US","og_type":"article","og_title":"No Comment(ing)? Not in PowerShell - Practical PowerShell","og_description":"Writing a script can be hard, making it reusable a bit harder and having someone else understand it’s purpose one of the hardest things you can do. To make your life and their life easier, the use of Comments is an easy way to enhance or augment a script. Below are a few examples of […]","og_url":"https:\/\/practicalpowershell.com\/no-commenting-not-in-powershell\/","og_site_name":"Practical PowerShell","article_published_time":"2018-06-11T14:00:27+00:00","article_modified_time":"2020-03-14T22:40:28+00:00","og_image":[{"url":"https:\/\/practicalpowershell.com\/wp-content\/uploads\/2020\/03\/Comments-150x150.jpg","type":"","width":"","height":""}],"author":"damian","twitter_card":"summary_large_image","twitter_misc":{"Written by":"damian","Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/practicalpowershell.com\/no-commenting-not-in-powershell\/#article","isPartOf":{"@id":"https:\/\/practicalpowershell.com\/no-commenting-not-in-powershell\/"},"author":{"name":"damian","@id":"https:\/\/practicalpowershell.com\/#\/schema\/person\/4d0733c81966e744aabbb49f56d64deb"},"headline":"No Comment(ing)? Not in PowerShell","datePublished":"2018-06-11T14:00:27+00:00","dateModified":"2020-03-14T22:40:28+00:00","mainEntityOfPage":{"@id":"https:\/\/practicalpowershell.com\/no-commenting-not-in-powershell\/"},"wordCount":401,"commentCount":0,"publisher":{"@id":"https:\/\/practicalpowershell.com\/#\/schema\/person\/4d0733c81966e744aabbb49f56d64deb"},"image":{"@id":"https:\/\/practicalpowershell.com\/no-commenting-not-in-powershell\/#primaryimage"},"thumbnailUrl":"https:\/\/practicalpowershell.com\/wp-content\/uploads\/2020\/03\/Comments-150x150.jpg","inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/practicalpowershell.com\/no-commenting-not-in-powershell\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/practicalpowershell.com\/no-commenting-not-in-powershell\/","url":"https:\/\/practicalpowershell.com\/no-commenting-not-in-powershell\/","name":"No Comment(ing)? Not in PowerShell - Practical PowerShell","isPartOf":{"@id":"https:\/\/practicalpowershell.com\/#website"},"primaryImageOfPage":{"@id":"https:\/\/practicalpowershell.com\/no-commenting-not-in-powershell\/#primaryimage"},"image":{"@id":"https:\/\/practicalpowershell.com\/no-commenting-not-in-powershell\/#primaryimage"},"thumbnailUrl":"https:\/\/practicalpowershell.com\/wp-content\/uploads\/2020\/03\/Comments-150x150.jpg","datePublished":"2018-06-11T14:00:27+00:00","dateModified":"2020-03-14T22:40:28+00:00","breadcrumb":{"@id":"https:\/\/practicalpowershell.com\/no-commenting-not-in-powershell\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/practicalpowershell.com\/no-commenting-not-in-powershell\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/practicalpowershell.com\/no-commenting-not-in-powershell\/#primaryimage","url":"https:\/\/i0.wp.com\/practicalpowershell.com\/wp-content\/uploads\/2020\/03\/Comments.jpg?fit=526%2C253&ssl=1","contentUrl":"https:\/\/i0.wp.com\/practicalpowershell.com\/wp-content\/uploads\/2020\/03\/Comments.jpg?fit=526%2C253&ssl=1","width":526,"height":253},{"@type":"BreadcrumbList","@id":"https:\/\/practicalpowershell.com\/no-commenting-not-in-powershell\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/practicalpowershell.com\/"},{"@type":"ListItem","position":2,"name":"No Comment(ing)? Not in PowerShell"}]},{"@type":"WebSite","@id":"https:\/\/practicalpowershell.com\/#website","url":"https:\/\/practicalpowershell.com\/","name":"Practical PowerShell","description":"PowerShell books written by experts","publisher":{"@id":"https:\/\/practicalpowershell.com\/#\/schema\/person\/4d0733c81966e744aabbb49f56d64deb"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/practicalpowershell.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":["Person","Organization"],"@id":"https:\/\/practicalpowershell.com\/#\/schema\/person\/4d0733c81966e744aabbb49f56d64deb","name":"damian","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/d5a8cc64a5aa27558a897b108e3be1a89859511a3fd26176dac292f26e7a4ae4?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/d5a8cc64a5aa27558a897b108e3be1a89859511a3fd26176dac292f26e7a4ae4?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/d5a8cc64a5aa27558a897b108e3be1a89859511a3fd26176dac292f26e7a4ae4?s=96&d=mm&r=g","caption":"damian"},"logo":{"@id":"https:\/\/secure.gravatar.com\/avatar\/d5a8cc64a5aa27558a897b108e3be1a89859511a3fd26176dac292f26e7a4ae4?s=96&d=mm&r=g"}}]}},"jetpack_featured_media_url":"","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/practicalpowershell.com\/wp-json\/wp\/v2\/posts\/586","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/practicalpowershell.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/practicalpowershell.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/practicalpowershell.com\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/practicalpowershell.com\/wp-json\/wp\/v2\/comments?post=586"}],"version-history":[{"count":1,"href":"https:\/\/practicalpowershell.com\/wp-json\/wp\/v2\/posts\/586\/revisions"}],"predecessor-version":[{"id":588,"href":"https:\/\/practicalpowershell.com\/wp-json\/wp\/v2\/posts\/586\/revisions\/588"}],"wp:attachment":[{"href":"https:\/\/practicalpowershell.com\/wp-json\/wp\/v2\/media?parent=586"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/practicalpowershell.com\/wp-json\/wp\/v2\/categories?post=586"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/practicalpowershell.com\/wp-json\/wp\/v2\/tags?post=586"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}