{"id":9391,"date":"2006-11-08T03:27:00","date_gmt":"2006-11-08T03:27:00","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/powershell\/2006\/11\/08\/dont-forget-your-gets-the-importance-of-naming-consistency\/"},"modified":"2019-02-18T13:21:12","modified_gmt":"2019-02-18T20:21:12","slug":"dont-forget-your-gets-the-importance-of-naming-consistency","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/powershell\/dont-forget-your-gets-the-importance-of-naming-consistency\/","title":{"rendered":"Don't forget your GETs – The importance of naming consistency"},"content":{"rendered":"

PowerShell and SMO are getting together like chocolate and peanut butter.  Yesterday I blogged about Bob Beauchemin’s TechEd talk about the today and today I see Dan Sullivan’s PowerSMO blog entry: http:\/\/pluralsight.com\/blogs\/dan\/archive\/2006\/11\/07\/41936.aspx<\/a> .   Dan includes the scripts he used in a ZIP file so you can easily use them.  I really liked what Dan is doing with one exception – his scripts don’t use the naming standards.  In particular, his scripts don’t use “get”.  For example, here is how it gets the SMO constructors: <\/p>\n

PS C:\\demos> SMO-ctors (SMOT-ManagedComputer)
ManagedComputer()
ManagedComputer(String machineName)
ManagedComputer(String machineName, String userName, String password)
ManagedComputer(String machineName, String userName, String password,
ProviderArchitecture providerArchitecture)
PS C:\\demos><\/p>\n

Cool function but where is my GET?  I want to take this example to make 2 points:<\/p>\n

    \n
  1. The community will get the naming consistency it demands.   We made the conscious decision to not put an naming enforcement mechanism into Windows PowerShell.  That means that we may or may not end up with a consistent set of names.  It is our shared responsibility to point out when the naming guidelines are not being used and to respectfully point this out and ask for change.  We don’t need to be butt heads about it but if we don’t push for consistency, we won’t get it.<\/li>\n
  2. I TOTALLY understand why it is tempting to drop your “get”s.  It can seem unnecessary and awkward at times.  The “get” makes sense after you implement the full set of verbs for a noun but you often start with the “get” and by itself, it can sometimes seem awkward.  <\/li>\n<\/ol>\n

    So here is the point about “gets” – You should ALWAYS define them but you don’t have to use them.  YUP- that’s right.   We’ve anticipated this issue and addressed in our design.  Let me give an example to illustrate.  Let’s say that you are about to develop a bunch of scripts manipulating  NumaNumas  (I don’t know if there is such a thing as a NumaNuma but I had that silly video on my mind ( https:\/\/www.youtube.com\/watch?v=60og9gwKh1o<\/a> ) so I thought I would use it. )  Anyway so the first thing you are going to do is to write a script (or cmdlet) which gets NUMAs and you might be tempted to define it as “NumaNuma” but DON’T  – you are not penalized for following the guidelines. <\/p>\n

    PS> Get-Command *numa*
    PS>
    PS> function Get-NumaNuma {“Numa Numa baby”}
    PS>
    PS> Get-NumaNuma
    Numa Numa baby
    PS>
    PS> NumaNuma
    Numa Numa baby<\/p>\n

    That’s right, the “GET” is optional!  The way our command resolution works is that we take the token you specify and look it up.  If we find it, we use it.  If we don’t find it, we stick a “GET-” in front of it and try again.  This means that you can define “Get-Numa” and invoke it with “numa” – the best of both worlds.   <\/p>\n

    Let me also quickly point out that if you follow the guidelines, it becomes pretty easy to develop a family of very pithy aliases.  Imagine that you have the following commands.<\/p>\n

    Get-NumaNuma
    Set-NumaNuma
    Export-NumaNuma
    Import-NumaNuma
    New-NumaNuma
    Clear-NumaNuma
    Copy-NumaNuma
    Invoke-NumaNuma
    Move-NumaNuma
    Remove-NumaNuma
    Rename-NumaNuma
    Stop-NumaNuma
    Start-NumaNuma<\/p>\n

    What you do is to pick a reasonable 2 or 3 letter term for your noun and then leverage our standard aliases for verbs to produce:<\/p>\n

     gnn   Get-NumaNuma
     snn   Set-NumaNuma
    epnn   Export-NumaNuma
    ipnn    Import-NumaNuma
     nnn    New-NumaNuma
    clnn    Clear-NumaNuma
     cnn    Copy-NumaNuma
     inn     Invoke-NumaNuma
     mnn   Move-NumaNuma
     rnn     Remove-NumaNuma
    rmnn   Rename-NumaNuma
    spnn   Stop-NumaNuma
    sann   Start-NumaNuma<\/p>\n

    The benefit is that it is consistent and therefore easy to learn and remember.  If we don’t press for consistency, we won’t get it and we’ll end up in a world that is unpredictable and therefore difficult to learn and remember.  By the way – check this out yourself by running the following commands:<\/p>\n

    gal g*
    gal *al<\/p>\n

    So Dan, I love your stuff but please don’t forget your “get”s.  <\/p>\n

    Cheers!<\/p>\n

    Jeffrey Snover [MSFT]
    Windows PowerShell\/MMC Architect
    Visit the Windows PowerShell Team blog at:        http:\/\/blogs.msdn.com\/PowerShell<\/a>
    Visit the Windows PowerShell ScriptCenter at:      http:\/\/www.microsoft.com\/technet\/scriptcenter\/hubs\/msh.mspx<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"

    PowerShell and SMO are getting together like chocolate and peanut butter.  Yesterday I blogged about Bob Beauchemin’s TechEd talk about the today and today I see Dan Sullivan’s PowerSMO blog entry: http:\/\/pluralsight.com\/blogs\/dan\/archive\/2006\/11\/07\/41936.aspx .   Dan includes the scripts he used in a ZIP file so you can easily use them.  I really liked what Dan is doing with […]<\/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-9391","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-powershell"],"acf":[],"blog_post_summary":"

    PowerShell and SMO are getting together like chocolate and peanut butter.  Yesterday I blogged about Bob Beauchemin’s TechEd talk about the today and today I see Dan Sullivan’s PowerSMO blog entry: http:\/\/pluralsight.com\/blogs\/dan\/archive\/2006\/11\/07\/41936.aspx .   Dan includes the scripts he used in a ZIP file so you can easily use them.  I really liked what Dan is doing with […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/posts\/9391","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=9391"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/posts\/9391\/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=9391"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/categories?post=9391"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/tags?post=9391"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}