{"id":4151,"date":"2009-04-22T18:53:00","date_gmt":"2009-04-22T18:53:00","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/powershell\/2009\/04\/22\/soliciting-new-verbs\/"},"modified":"2019-02-18T13:12:41","modified_gmt":"2019-02-18T20:12:41","slug":"soliciting-new-verbs","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/powershell\/soliciting-new-verbs\/","title":{"rendered":"Soliciting New Verbs"},"content":{"rendered":"<p>With the recent changes in v2 to <a title=\"increase the visibility of the cmdlet design guidelines\" href=\"http:\/\/blogs.msdn.com\/powershell\/archive\/2009\/04\/16\/increasing-visibility-of-cmdlet-design-guidelines.aspx\">increase the visibility of the cmdlet design guidelines<\/a>, we want to make sure we have a solid set of verbs on the approved verb list before we ship v2. We&#8217;ve already talked with a number of partners and customers and have made some recent changes to the verb list. In addition, we&#8217;d love to have feedback from our community on any holes you perceive we have in our current list of approved verbs.<\/p>\n<p>To provide some context, here are the things we think about when deciding whether to add a new verb:<\/p>\n<ul>\n<li>Little or no overlap with existing approved verbs<\/li>\n<li>Broadly applicable to multiple technologies &#8211; must be domain agnostic<\/li>\n<li>Used consistently with similar meaning across multiple contexts<\/li>\n<li>Pairing with an opposite is good, but not required<\/li>\n<\/ul>\n<p>When suggesting a new verb, it&#8217;s most helpful if you can include the following information in your suggestion:<\/p>\n<ul>\n<li>Verb name<\/li>\n<li>Description<\/li>\n<li>Category<\/li>\n<li>List of at least 5 significantly different applicable domains<\/li>\n<li>List of at least 3 alternative verbs from the approved list<\/li>\n<li>Pair with (optional)<\/li>\n<\/ul>\n<p>For example, we recently approved Open and Close as new verbs in v2. Our internal discussions boiled down to the following:<\/p>\n<ul>\n<li>Verb name: Open<\/li>\n<li>Description: To set a resource to its opened state or make it accessible, visible, or available<\/li>\n<li>Category: Common<\/li>\n<li>List of at least 5 significantly different applicable domains: file, port, dialog, door, archive, container, account, mailbox, queue, chamber, scriptblock<\/li>\n<li>List of at least 3 alternative verbs from the approved list: Set, Use, Enable, Show<\/li>\n<li>Pair with: Close<\/li>\n<\/ul>\n<p>Here is our current list of approved verbs:<\/p>\n<table>\n<tbody>\n<tr>\n<td>Verb<\/td>\n<td>Category<\/td>\n<\/tr>\n<tr>\n<td>&#8212;&#8212;<\/td>\n<td>&#8212;&#8212;&#8212;&#8212;-<\/td>\n<\/tr>\n<tr>\n<td>Add<\/td>\n<td>Common<\/td>\n<\/tr>\n<tr>\n<td>Clear<\/td>\n<td>Common<\/td>\n<\/tr>\n<tr>\n<td>Close<\/td>\n<td>Common<\/td>\n<\/tr>\n<tr>\n<td>Copy<\/td>\n<td>Common<\/td>\n<\/tr>\n<tr>\n<td>Enter<\/td>\n<td>Common<\/td>\n<\/tr>\n<tr>\n<td>Exit<\/td>\n<td>Common<\/td>\n<\/tr>\n<tr>\n<td>Format<\/td>\n<td>Common<\/td>\n<\/tr>\n<tr>\n<td>Get<\/td>\n<td>Common<\/td>\n<\/tr>\n<tr>\n<td>Hide<\/td>\n<td>Common<\/td>\n<\/tr>\n<tr>\n<td>Join<\/td>\n<td>Common<\/td>\n<\/tr>\n<tr>\n<td>Lock<\/td>\n<td>Common<\/td>\n<\/tr>\n<tr>\n<td>Move<\/td>\n<td>Common<\/td>\n<\/tr>\n<tr>\n<td>New<\/td>\n<td>Common<\/td>\n<\/tr>\n<tr>\n<td>Open<\/td>\n<td>Common<\/td>\n<\/tr>\n<tr>\n<td>Pop<\/td>\n<td>Common<\/td>\n<\/tr>\n<tr>\n<td>Push<\/td>\n<td>Common<\/td>\n<\/tr>\n<tr>\n<td>Redo<\/td>\n<td>Common<\/td>\n<\/tr>\n<tr>\n<td>Remove<\/td>\n<td>Common<\/td>\n<\/tr>\n<tr>\n<td>Rename<\/td>\n<td>Common<\/td>\n<\/tr>\n<tr>\n<td>Reset<\/td>\n<td>Common<\/td>\n<\/tr>\n<tr>\n<td>Search<\/td>\n<td>Common<\/td>\n<\/tr>\n<tr>\n<td>Select<\/td>\n<td>Common<\/td>\n<\/tr>\n<tr>\n<td>Set<\/td>\n<td>Common<\/td>\n<\/tr>\n<tr>\n<td>Show<\/td>\n<td>Common<\/td>\n<\/tr>\n<tr>\n<td>Split<\/td>\n<td>Common<\/td>\n<\/tr>\n<tr>\n<td>Switch<\/td>\n<td>Common<\/td>\n<\/tr>\n<tr>\n<td>Undo<\/td>\n<td>Common<\/td>\n<\/tr>\n<tr>\n<td>Unlock<\/td>\n<td>Common<\/td>\n<\/tr>\n<tr>\n<td>Backup<\/td>\n<td>Data<\/td>\n<\/tr>\n<tr>\n<td>Checkpoint<\/td>\n<td>Data<\/td>\n<\/tr>\n<tr>\n<td>Compare<\/td>\n<td>Data<\/td>\n<\/tr>\n<tr>\n<td>Compress<\/td>\n<td>Data<\/td>\n<\/tr>\n<tr>\n<td>Convert<\/td>\n<td>Data<\/td>\n<\/tr>\n<tr>\n<td>ConvertFrom&nbsp;&nbsp;&nbsp;<\/td>\n<td>Data<\/td>\n<\/tr>\n<tr>\n<td>ConvertTo<\/td>\n<td>Data<\/td>\n<\/tr>\n<tr>\n<td>Dismount<\/td>\n<td>Data<\/td>\n<\/tr>\n<tr>\n<td>Edit<\/td>\n<td>Data<\/td>\n<\/tr>\n<tr>\n<td>Expand<\/td>\n<td>Data<\/td>\n<\/tr>\n<tr>\n<td>Export<\/td>\n<td>Data<\/td>\n<\/tr>\n<tr>\n<td>Import<\/td>\n<td>Data<\/td>\n<\/tr>\n<tr>\n<td>Initialize<\/td>\n<td>Data<\/td>\n<\/tr>\n<tr>\n<td>Limit<\/td>\n<td>Data<\/td>\n<\/tr>\n<tr>\n<td>Merge<\/td>\n<td>Data<\/td>\n<\/tr>\n<tr>\n<td>Mount<\/td>\n<td>Data<\/td>\n<\/tr>\n<tr>\n<td>Out<\/td>\n<td>Data<\/td>\n<\/tr>\n<tr>\n<td>Publish<\/td>\n<td>Data<\/td>\n<\/tr>\n<tr>\n<td>Restore<\/td>\n<td>Data<\/td>\n<\/tr>\n<tr>\n<td>Save<\/td>\n<td>Data<\/td>\n<\/tr>\n<tr>\n<td>Unpublish<\/td>\n<td>Data<\/td>\n<\/tr>\n<tr>\n<td>Update<\/td>\n<td>Data<\/td>\n<\/tr>\n<tr>\n<td>Complete<\/td>\n<td>Lifecyle<\/td>\n<\/tr>\n<tr>\n<td>Disable<\/td>\n<td>Lifecycle<\/td>\n<\/tr>\n<tr>\n<td>Enable<\/td>\n<td>Lifecycle<\/td>\n<\/tr>\n<tr>\n<td>Install<\/td>\n<td>Lifecycle<\/td>\n<\/tr>\n<tr>\n<td>Invoke<\/td>\n<td>Lifecycle<\/td>\n<\/tr>\n<tr>\n<td>Register<\/td>\n<td>Lifecycle<\/td>\n<\/tr>\n<tr>\n<td>Restart<\/td>\n<td>Lifecycle<\/td>\n<\/tr>\n<tr>\n<td>Resume<\/td>\n<td>Lifecycle<\/td>\n<\/tr>\n<tr>\n<td>Start<\/td>\n<td>Lifecycle<\/td>\n<\/tr>\n<tr>\n<td>Stop<\/td>\n<td>Lifecycle <\/td>\n<\/tr>\n<tr>\n<td>Suspend<\/td>\n<td>Lifecycle <\/td>\n<\/tr>\n<tr>\n<td>Uninstall<\/td>\n<td>Lifecycle <\/td>\n<\/tr>\n<tr>\n<td>Unregister<\/td>\n<td>Lifecycle <\/td>\n<\/tr>\n<tr>\n<td>Wait<\/td>\n<td>Lifecycle <\/td>\n<\/tr>\n<tr>\n<td>Debug<\/td>\n<td>Diagnostic <\/td>\n<\/tr>\n<tr>\n<td>Measure<\/td>\n<td>Diagnostic <\/td>\n<\/tr>\n<tr>\n<td>Ping<\/td>\n<td>Diagnostic <\/td>\n<\/tr>\n<tr>\n<td>Repair<\/td>\n<td>Diagnostic <\/td>\n<\/tr>\n<tr>\n<td>Resolve<\/td>\n<td>Diagnostic <\/td>\n<\/tr>\n<tr>\n<td>Test<\/td>\n<td>Diagnostic <\/td>\n<\/tr>\n<tr>\n<td>Trace<\/td>\n<td>Diagnostic <\/td>\n<\/tr>\n<tr>\n<td>Connect<\/td>\n<td>Communications <\/td>\n<\/tr>\n<tr>\n<td>Disconnect<\/td>\n<td>Communications <\/td>\n<\/tr>\n<tr>\n<td>Read<\/td>\n<td>Communications <\/td>\n<\/tr>\n<tr>\n<td>Receive<\/td>\n<td>Communications <\/td>\n<\/tr>\n<tr>\n<td>Send<\/td>\n<td>Communications <\/td>\n<\/tr>\n<tr>\n<td>Write<\/td>\n<td>Communications <\/td>\n<\/tr>\n<tr>\n<td>Block<\/td>\n<td>Security <\/td>\n<\/tr>\n<tr>\n<td>Grant<\/td>\n<td>Security <\/td>\n<\/tr>\n<tr>\n<td>Revoke<\/td>\n<td>Security <\/td>\n<\/tr>\n<tr>\n<td>Unblock<\/td>\n<td>Security <\/td>\n<\/tr>\n<tr>\n<td>Use<\/td>\n<td>Other <\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Thanks,<br \/>Dan Harman<br \/>Program Manager<br \/>Windows PowerShell<\/p>\n","protected":false},"excerpt":{"rendered":"<p>With the recent changes in v2 to increase the visibility of the cmdlet design guidelines, we want to make sure we have a solid set of verbs on the approved verb list before we ship v2. We&#8217;ve already talked with a number of partners and customers and have made some recent changes to the verb [&hellip;]<\/p>\n","protected":false},"author":600,"featured_media":13641,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[],"class_list":["post-4151","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-powershell"],"acf":[],"blog_post_summary":"<p>With the recent changes in v2 to increase the visibility of the cmdlet design guidelines, we want to make sure we have a solid set of verbs on the approved verb list before we ship v2. We&#8217;ve already talked with a number of partners and customers and have made some recent changes to the verb [&hellip;]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/posts\/4151","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/users\/600"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/comments?post=4151"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/posts\/4151\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/media\/13641"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/media?parent=4151"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/categories?post=4151"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/tags?post=4151"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}