{"id":10581,"date":"2006-04-25T12:18:19","date_gmt":"2006-04-25T12:18:19","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/powershell\/2006\/04\/25\/finding-which-parameters-are-used-the-most\/"},"modified":"2019-02-18T13:24:55","modified_gmt":"2019-02-18T20:24:55","slug":"finding-which-parameters-are-used-the-most","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/powershell\/finding-which-parameters-are-used-the-most\/","title":{"rendered":"Finding which parameters are used the most"},"content":{"rendered":"

We are in the process of cleaning up our Cmdlets and ensuring that they are consistent.  One of the things we want to do is the ensure that we provide Aliases for ParameterNames.  As a general rule, parameternames are not pithy.  That is great for reading scripts but can be a pain during interactive sessions.  You only have to provide enough of a parametername to disambiguate it but you can also use parameter aliases if they are defined.  For instance, you can type -OutVariable or you can type -ov because all the commands provide the alias “ov” to map to “OutVariable”.  <\/span><\/span><\/p>\n

<\/span><\/span> <\/p>\n

<\/span>The task at hand is to ensure that we make good use of parameter aliases.  As always, \u201cto ship is to choose\u201d.  <\/span>That means that we don\u2019t time to do everything so we have to focus on the things that are going to produce the biggest bang for the buck.  <\/span>Here I walk through the steps to get a histogram of parameter use by all the Cmdlets.   <\/span>Let\u2019s break that down into steps:<\/span><\/p>\n

1)    <\/span><\/span><\/span>Get all the Cmdlets<\/span><\/p>\n

2)    <\/span><\/span><\/span>Get all the parameters of all the Cmdlets<\/span><\/p>\n

3)    <\/span><\/span><\/span>Create a histogram<\/span><\/p>\n

 <\/span><\/p>\n

Getting all the Cmdlets is pretty simple to do \u2013 we provide the \u201cGet-Command\u201d function which has the alias \u201cgcm\u201d<\/span><\/p>\n

MSH> gcm<\/strong><\/font><\/font><\/font><\/span><\/p>\n

 <\/font><\/span><\/p>\n

CommandType     <\/span>Name                      <\/span>Definition<\/font><\/font><\/font><\/span><\/p>\n

———–     <\/span>—-                      <\/span>———-<\/font><\/font><\/font><\/span><\/p>\n

Cmdlet          <\/span>add-content               <\/span>add-content [-Path] St…<\/font><\/font><\/font><\/span><\/p>\n

Cmdlet          <\/span>add-history               <\/span>add-history [[-InputOb…<\/font><\/font><\/font><\/span><\/p>\n

\u2026.<\/font><\/font><\/font><\/span><\/p>\n

 <\/span><\/p>\n

If you provide no parameters, gcm returns the list of all Cmdlets.  <\/span>If you provide a name specifier (you can use wildcards), then it returns everything that can resolve a token.  <\/span>You can type \u201cgcm *\u201d to see what that looks like.  <\/span>I\u2019ll group them to show you want I mean:<\/span><\/p>\n

 <\/font><\/span><\/p>\n

MSH> gcm * |Group CommandType |Sort name<\/strong><\/font><\/font><\/font><\/span><\/p>\n

 <\/font><\/span><\/p>\n

Count Name                      <\/span>Group<\/font><\/font><\/font><\/span><\/p>\n

—– —-                      <\/span>—–<\/font><\/font><\/font><\/span><\/p>\n

  <\/span>120 Alias                     <\/span>{ac, alias, aliases, cat, cd, ch…<\/font><\/font><\/font><\/span><\/p>\n

 <\/span>2746 Application               <\/span>{$ncsp$.inf, $winnt$.inf, _defau…<\/font><\/font><\/font><\/span><\/p>\n

  <\/span>128 Cmdlet                    <\/span>{add-content, add-history, add-m…<\/font><\/font><\/font><\/span><\/p>\n

   <\/span>25 ExternalScript            <\/span>{aliases.msh, aspen.msh, burn-co…<\/font><\/font><\/font><\/span><\/p>\n

   <\/span>64 Function                  <\/span>{…, A:, Alias:, Aspen:, B:, C:…<\/font><\/font><\/font><\/span><\/p>\n

 <\/span><\/p>\n

For this work, we are only interested in Cmdlets so how do we find just the Cmdlets?  <\/span><\/span><\/p>\n

 <\/span><\/p>\n

The thing I love about Monad is that with a few concepts, you can do almost anything.  <\/span>Since you know that gcm returns objects and you know that you can filter objects using \u201cwhere\u201d, the following gives you exactly what you want:<\/span><\/p>\n

 <\/span><\/p>\n

MSH> gcm * |where {$_.CommandType -eq “Cmdlet”}<\/font><\/strong><\/font><\/font><\/font><\/span><\/p>\n

 <\/font><\/span><\/p>\n

With that as a baseline, let\u2019s explore whether there is a better way to do things.  <\/span>Type \u201cgcm -?\u201d and you\u2019ll get help on \u201cGet-Command\u201d and it will tell you all sorts of wonderful things.  <\/span>I\u2019m one of those \u201cless is more\u201d type of readers so I often just want the examples. I do this to get just the examples:<\/span><\/p>\n

 <\/font><\/span><\/p>\n

MSH> (gcm -?).Examples<\/strong><\/font><\/font><\/font><\/span><\/p>\n

 <\/span><\/p>\n

In this case it doesn\u2019t tell me what I wanted to see (looks like we need to cleanup our help as well <\/span>J<\/span><\/span>) so let\u2019s use gcm on Get-Command:<\/span><\/p>\n

 <\/font><\/span><\/p>\n

MSH> gcm Get-Command |fl *<\/strong><\/font><\/font><\/font><\/span><\/p>\n

DLL           <\/span>: C:\\WINDOWS\\assembly\\GAC_MSIL\\System.Management.Auto<\/font><\/font><\/font><\/span><\/p>\n

                <\/span>mation\\1.0.7487.0__31bf3856ad364e35\\System.Manageme<\/font><\/font><\/font><\/span><\/p>\n

                <\/span>nt.Automation.dll<\/font><\/font><\/font><\/span><\/p>\n

Verb          <\/span>: get<\/font><\/font><\/font><\/span><\/p>\n

Noun          <\/span>: command<\/font><\/font><\/font><\/span><\/p>\n

HelpFile     <\/span> <\/span>: System.Management.Automation.dll-Help.xml<\/font><\/font><\/font><\/span><\/p>\n

MshSnapIn     <\/span>: Microsoft.Management.Automation.Core<\/font><\/font><\/font><\/span><\/p>\n

Type          <\/span>: System.Management.Automation.Commands.GetCommand<\/font><\/font><\/font><\/span><\/p>\n

ParameterSets : {CmdletSet, AllCommandSet}<\/font><\/font><\/font><\/span><\/p>\n

Definition    <\/span>: get-command [[-CommandArguments] Object[]] [-Verb S<\/font><\/font><\/font><\/span><\/p>\n

                <\/span>tring[]] [-Noun String[]] [-MshSnapin String[]] [-T<\/font><\/font><\/font><\/span><\/p>\n

                <\/span>otalCount Int32] [-Synopsis] [-Verbose] [-Debug] [-<\/font><\/font><\/font><\/span><\/p>\n

                <\/span>ErrorAction ActionPreference] [-ErrorVariable Strin<\/font><\/font><\/font><\/span><\/p>\n

                <\/span>g] [-OutVariable String] [-OutBuffer Int32]<\/font><\/font><\/font><\/span><\/p>\n

                <\/span>get-command [[-Name] String[]] [[-CommandArguments]<\/font><\/font><\/font><\/span><\/p>\n

                 <\/span>Object[]] [-Type CommandTypes]<\/font><\/strong> [-TotalCount Int32]<\/font><\/font><\/font><\/span><\/p>\n

                 <\/span>[-Synopsis] [-Verbose] [-Debug] [-ErrorAction Acti<\/font><\/font><\/font><\/span><\/p>\n

                <\/span>onPreference] [-ErrorVariable String] [-OutVariable<\/font><\/font><\/font><\/span><\/p>\n

                 <\/span>String] [-OutBuffer Int32]<\/font><\/font><\/font><\/span><\/p>\n

 <\/font><\/span><\/p>\n

Name          <\/span>: get-command<\/font><\/font><\/font><\/span><\/p>\n

CommandType   <\/span>: Cmdlet<\/font><\/font><\/font><\/span><\/p>\n

 <\/font><\/span><\/p>\n

This tells me that I can use \u201c-Type Cmdlet\u201d to get just the items I want:<\/span><\/p>\n

 <\/font><\/span><\/p>\n

MSH> gcm \u2013Type Cmdlet<\/strong><\/font><\/font><\/font><\/span><\/p>\n

 <\/span><\/p>\n

Notice also that gcm shows you the ParameterSets.  <\/span>Every command can have multiple sets of parameters.  <\/span>For instance you can do a \u201cget-process\u201d specifying either an ID or a ProcessName or by pipelining a set of instance to the command.<\/span><\/p>\n

 <\/span><\/p>\n

MSH> (gcm get-process).parametersets |ft name,parameters -Auto<\/strong><\/font><\/font><\/font><\/span><\/p>\n

 <\/font><\/span><\/p>\n

Name        <\/span>Parameters<\/font><\/font><\/font><\/span><\/p>\n

—-        <\/span>———-<\/font><\/font><\/font><\/span><\/p>\n

ProcessName {ProcessName, Verbose, Debug, ErrorAction, ErrorVari…<\/font><\/font><\/font><\/span><\/p>\n

Id          <\/span>{Id, Verbose, Debug, ErrorAction, ErrorVariable, Out…<\/font><\/font><\/font><\/span><\/p>\n

Input       <\/span>{Input, Verbose, Debug, ErrorAction, ErrorVariable, …<\/font><\/font><\/font><\/span><\/p>\n

 <\/span><\/p>\n

So now what we want to do is to get all the parameters of all the ParameterSets of all the commands which are Cmdlets.  <\/span>First let\u2019s get all the ParameterSets.  <\/span>We know that gcm returns all the properties of the Cmdlet and that \u201cselect\u201d can be used to pick just those properties that we want so it seems like we should be able to do the following:<\/span><\/p>\n

 <\/span><\/p>\n

MSH> gcm -type Cmdlet |Select ParameterSets<\/strong><\/font><\/font><\/font><\/span><\/p>\n

 <\/span><\/p>\n

Do this and you\u2019ll discover that it doesn\u2019t quite give you want you want because Parametersets is a Collection.  <\/span>That command sequence returns a stream of collections when what we want is a stream of objects.  <\/span>This is what \u201cSelect \u2013Expand \u201c is designed to do.<\/span><\/p>\n

 <\/span><\/p>\n

MSH> gcm -type Cmdlet |Select -Expand ParameterSets |Select -Expand<\/font><\/font><\/font><\/span><\/p>\n

Parameters<\/font><\/font><\/font><\/span><\/p>\n

 <\/font><\/span><\/p>\n

 <\/font><\/span><\/p>\n

Name                            <\/span>: Value<\/font><\/font><\/font><\/span><\/p>\n

Type                            <\/span>: System.Object[]<\/font><\/font><\/font><\/span><\/p>\n

IsMandatory                     <\/span>: True<\/font><\/font><\/font><\/span><\/p>\n

IsDynamic                       <\/span>: False<\/font><\/font><\/font><\/span><\/p>\n

Position                        <\/span>: 1<\/font><\/font><\/font><\/span><\/p>\n

ValueFromPipeline               <\/span>: True<\/font><\/font><\/font><\/span><\/p>\n

ValueFromPipelineByPropertyName : True<\/font><\/font><\/font><\/span><\/p>\n

ValueFromRemainingArguments     <\/span>: False<\/font><\/font><\/font><\/span><\/p>\n

HelpMessage            <\/span>         <\/span>:<\/font><\/font><\/font><\/span><\/p>\n

Aliases                         <\/span>: {}<\/font><\/font><\/font><\/span><\/p>\n

Attributes                      <\/span>: {System.Management.Automation.All<\/font><\/font><\/font><\/span><\/p>\n

                                  <\/span>owNullAttribute, System.Managemen<\/font><\/font><\/font><\/span><\/p>\n

                                  <\/span>t.Automation.AllowEmptyCollection<\/font><\/font><\/font><\/span><\/p>\n

    <\/span>                              <\/span>Attribute, __AllParameterSets}<\/font><\/font><\/font><\/span><\/p>\n

\u2026.<\/font><\/font><\/font><\/span><\/p>\n

 <\/font><\/span><\/p>\n

 <\/font><\/span><\/p>\n

 <\/span><\/p>\n

 <\/span><\/p>\n

 <\/span> <\/span><\/p>\n

Now we are ready to party.  <\/span>Let\u2019s put these parameters in a variable so the subsequent commandlines are easier to read.<\/span><\/p>\n

MSH> $p = gcm -type Cmdlet  <\/span>|Select -Expand ParameterSets |Select -Expand Parameters<\/strong><\/font><\/font><\/font><\/span><\/p>\n

 <\/span><\/p>\n

 <\/span><\/p>\n

Now we want to produce a histogram:<\/span><\/p>\n

 <\/span><\/p>\n

MSH> $p |group Name<\/strong><\/font><\/font><\/font><\/span><\/p>\n

 <\/font><\/span><\/p>\n

Count Name                      <\/span>Group<\/font><\/font><\/font><\/span><\/p>\n

—– —-                      <\/span>—–<\/font><\/font><\/font><\/span><\/p>\n

   <\/span>12 Value                     <\/span>{Value, Value, Value, Value, Val…<\/font><\/font><\/font><\/span><\/p>\n

   <\/span>47 PassThru                  <\/span>{PassThru, Passthru, PassThru, P…<\/font><\/font><\/font><\/span><\/p>\n

   <\/span>50 Path                      <\/span>{Path, Path, Path, Path, Path, P…<\/font><\/font><\/font><\/span><\/p>\n

   <\/span>26 Filter                    <\/span>{Filter, Filter, Filter, Filter,…<\/font><\/font><\/font><\/span><\/p>\n

   <\/span>49 Include                   <\/span>{Include, Include, Include, Incl…<\/font><\/font><\/font><\/span><\/p>\n

\u2026<\/font><\/font><\/font><\/span><\/p>\n

 <\/span><\/p>\n

We want to focus on the ones that matter the most so let\u2019s find out which parameters are used the most:<\/span><\/p>\n

 <\/span><\/p>\n

MSH> $p |group Name |sort -Descending count<\/strong><\/font><\/font><\/font><\/span><\/p>\n

 <\/font><\/span><\/p>\n

Count Name                      <\/span>Group<\/font><\/font><\/font><\/span><\/p>\n

—– —-                      <\/span>—–<\/font><\/font><\/font><\/span><\/p>\n

  <\/span>174 ErrorAction               <\/span>{ErrorAction, ErrorAction, Error…<\/font><\/font><\/font><\/span><\/p>\n

  <\/span>174 Debug                     <\/span>{Debug, Debug, Debug, Debug, Deb…<\/font><\/font><\/font><\/span><\/p>\n

  <\/span>174 Verbose                   <\/span>{Verbose, Verbose, Verbose, Verb…<\/font><\/font><\/font><\/span><\/p>\n

  <\/span>174 OutBuffer                 <\/span>{OutBuffer, OutBuffer, OutBuffer…<\/font><\/font><\/font><\/span><\/p>\n

  <\/span>174 OutVariable               <\/span>{OutVariable, OutVariable, OutVa…<\/font><\/font><\/font><\/span><\/p>\n

\u2026<\/font><\/font><\/font><\/span><\/p>\n

 <\/span><\/p>\n

Now notice that the most used parameters are the ubiquitous parameters.  <\/span>Pretty obvious really, when you think about the word \u201cubiquitous\u201d <\/span>J<\/span><\/span> .  <\/span><Digression \u2013 Cmdlets are subclasses of a base .Net class.  <\/span>Ubiquitous parameters are parameters that we put on the base class so that all commands inherit them and whose behavior is implemented by the Monad Cmdlet hosting environment.  <\/span>For example, -OutVariable allows you to take the results of a command and assign or append it to a variable [as well as passing it on].  <\/span>When a Cmdlet writes its results, Monad looks to see if the user has specified \u2013OutVariable and it does this work [not the Cmdlet].><\/span><\/p>\n

 <\/span><\/p>\n

The command line is about to get large again so let\u2019s put the results into another variable and for yucks let\u2019s use \u2013OutVariable.  <\/span>Of course who wants to type \u2013OutVariable so let\u2019s use its alias \u2013ov.  <\/span>It turns out that we already have good aliases for the ubiquitous parameters so we want to find the top 20 non-ubiquitous parameters.<\/span><\/p>\n

MSH> $p |group Name |sort -Descending count \u2013ov p1<\/strong><\/font><\/font><\/font><\/span><\/p>\n

 <\/font><\/span><\/p>\n

Count Name                      <\/span>Group<\/font><\/font><\/font><\/span><\/p>\n

—– —-                      <\/span>—–<\/font><\/font><\/font><\/span><\/p>\n

  <\/span>174 ErrorAction               <\/span>{ErrorAction, ErrorAction, Error…<\/font><\/font><\/font><\/span><\/p>\n

  <\/span>174 Debug                     <\/span>{Debug, Debug, Debug, Debug, Deb…<\/font><\/font><\/font><\/span><\/p>\n

  <\/span>174 Verbose                   <\/span>{Verbose, Verbose, Verbose, Verb…<\/font><\/font><\/font><\/span><\/p>\n

  <\/span>174 OutBuffer                 <\/span>{OutBuffer, OutBuffer, OutBuffer…<\/font><\/font><\/font><\/span><\/p>\n

  <\/span>174 OutVariable               <\/span>{OutVariable, OutVariable, OutVa…<\/font><\/font><\/font><\/span><\/p>\n

\u2026<\/font><\/font><\/font><\/span><\/p>\n

 <\/font><\/span><\/p>\n

 <\/span><\/p>\n

There are 6 ubiquitous parameter so there are 2 ways to get the top 20:<\/span><\/p>\n

MSH> $p1 |select -first 26 |select -Last 20 \u2013ov p2<\/strong><\/font><\/font><\/font><\/span><\/p>\n

MSH> $p1[6..25]<\/strong><\/font><\/font><\/font><\/span><\/p>\n

 <\/font><\/span><\/p>\n

Count Name                      <\/span>Group<\/font><\/font><\/font><\/span><\/p>\n

—– —-                      <\/span>—–<\/font><\/font><\/font><\/span><\/p>\n

   <\/span>52 WhatIf                    <\/span>{WhatIf, WhatIf, WhatIf, WhatIf,…<\/font><\/font><\/font><\/span><\/p>\n

   <\/span>52 Confirm                   <\/span>{Confirm, Confirm, Confirm, Conf…<\/font><\/font><\/font><\/span><\/p>\n

   <\/span>50 Path                 <\/span>     <\/span>{Path, Path, Path, Path, Path, P…<\/font><\/font><\/font><\/span><\/p>\n

   <\/span>50 Exclude                   <\/span>{Exclude, Exclude, Exclude, Excl…<\/font><\/font><\/font><\/span><\/p>\n

   <\/span>49 Include                   <\/span>{Include, Include, Include, Incl…<\/font><\/font><\/font><\/span><\/p>\n

   <\/span>47 PassThru                  <\/span>{PassThru, Passthru, PassThru, P…<\/font><\/font><\/font><\/span><\/p>\n

   <\/span>43 Force                     <\/span>{Force, Force, Force, Force, For…<\/font><\/font><\/font><\/span><\/p>\n

   <\/span>37 Credential                <\/span>{Credential, Credential, Credent…<\/font><\/font><\/font><\/span><\/p>\n

   <\/span>32 InputObject               <\/span>{InputObject, InputObject, Input…<\/font><\/font><\/font><\/span><\/p>\n

   <\/span>29 Name                      <\/span>{Name, Name, Name, Name, Name, N…<\/font><\/font><\/font><\/span><\/p>\n

   <\/span>26 Filter                    <\/span>{Filter, Filter, Filter, Filter,…<\/font><\/font><\/font><\/span><\/p>\n

   <\/span>20 Property                  <\/span>{Property, Property, Property, P…<\/font><\/font><\/font><\/span><\/p>\n

   <\/span>13 Scope                     <\/span>{Scope, Scope, Scope, Scope, Sco…<\/font><\/font><\/font><\/span><\/p>\n

   <\/span>12 Value                     <\/span>{Value, Value, Value, Value, Val…<\/font><\/font><\/font><\/span><\/p>\n

    <\/span>8 Description               <\/span>{Description, Description, Descr…<\/font><\/font><\/font><\/span><\/p>\n

    <\/span>8 DisplayName               <\/span>{DisplayName, DisplayName, Displ…<\/font><\/font><\/font><\/span><\/p>\n

    <\/span>8 ServiceName               <\/span>{ServiceName, ServiceName, Servi…<\/font><\/font><\/font><\/span><\/p>\n

    <\/span>8 Input                     <\/span>{Input, Input, Input, Input, Inp…<\/font><\/font><\/font><\/span><\/p>\n

    <\/span>6 Type                      <\/span>{Type, Type, Type, Type, Type, T…<\/font><\/font><\/font><\/span><\/p>\n

    <\/span>6 Encoding                  <\/span>{Encoding, Encoding, Encoding, E…<\/font><\/font><\/font><\/span><\/p>\n

 <\/span><\/p>\n

Now let\u2019s turn the dial to 11 and see if these things already have aliases and if so, whether there are inconsistent aliases.  <\/span>I\u2019m going to make the assumption that if a parameter has an alias, it only has 1 alias (I validated this assumption with the following command \u201c$p2 |select -expand group |where {$_.aliases.count -gt 1}\u201d ).<\/span><\/p>\n

 <\/span><\/p>\n

The Group command keeps the things it grouped in a property called group.  <\/span>We grouped parameters so this command gets us back the parameters:<\/span><\/p>\n

 <\/span><\/p>\n

MSH> $p2 |select -expand group<\/strong><\/font><\/font><\/font><\/span><\/p>\n

 <\/span><\/p>\n

We now want to group these parameters by Name AND alias.  <\/span>The issue is that the parameter class does not have such a property.  <\/span>No problem!  <\/span>Remember \u2013 Monad is all about helping you cope with a world that doesn\u2019t give you want you need.  <\/span>(If it did, you wouldn\u2019t need us <\/span>J<\/span><\/span> ).  <\/span>Also remember that there are a small set of KEY MONAD CONCEPTS and TECHNIQUES that you need to learn and then the world is your oyster.  <\/span>The technique that saves us here is ScriptBlock Parameters.<\/span><\/p>\n

 <\/span><\/p>\n

I mentioned that we are turning to dial to 11 didn\u2019t I?  <\/span>OK \u2013 put your seatbelt on.<\/span><\/p>\n

 <\/span><\/p>\n

When you pipeline data to a command, you can specify a ScriptBlock to a parameter that does not take a ScriptBlock.  <\/span>The Monad engine detects this and for every pipelined object, it assigns that object to the variable $_, evaluates the ScriptBlock and assigns the results to the parameter.  <\/span>Let\u2019s provide a simple example.  <\/span>Here we pipe 2 integers to the stop-process command.  <\/span>We provide a ScriptBlock to the parameter \u2013ID which only accepts INTs.  <\/span>The ScriptBlock issues a prompt and asks the user to enter a process id.  <\/span>Monad assigns the pipelined objects (1 and 2) to $_, evaluates the ScriptBlock and passes the parameter to \u2013ProcessName.<\/span><\/p>\n

 <\/span><\/p>\n

MSH> 1..2 |Stop-Process -ProcessName {Read-host “Record $_  <\/span>Name” } -whatif<\/strong><\/font><\/font><\/font><\/span><\/p>\n

Record 1  <\/span>Name: lsass<\/font><\/font><\/font><\/span><\/p>\n

What if: Performing operation “stop-process” on Target “lsass (1440)”.<\/font><\/font><\/font><\/span><\/p>\n

Record 2  <\/span>Name: msh<\/font><\/font><\/font><\/span><\/p>\n

What if: Performing operation “stop-process” on Target “msh (3428)”.<\/font><\/font><\/font><\/span><\/p>\n

 <\/span><\/p>\n

 <\/span><\/p>\n

 <\/span><\/p>\n

Back to the problem at hand.  <\/span>We want to group these parameters by Name and Alias so let\u2019s use the fact that Group can group by multiple parameters and use a ScriptBlock as one of those parameters:<\/span><\/p>\n

 <\/span><\/p>\n

MSH> $p2|select -Expand Group |group Name,{$_.Aliases[0]} |sort name<\/strong><\/font><\/font><\/font><\/span><\/p>\n

 <\/font><\/span><\/p>\n

Count Name                      <\/span>Group<\/font><\/font><\/font><\/span><\/p>\n

—– —-                      <\/span>—–<\/font><\/font><\/font><\/span><\/p>\n

   <\/span>52 Confirm.cf                <\/span>{Confirm, Confirm, Confirm, Conf…<\/font><\/font><\/font><\/span><\/p>\n

   <\/span>37 Credential                <\/span>{Credential, Credential, Credent…<\/font><\/font><\/font><\/span><\/p>\n

    <\/span>8 Description               <\/span>{Description, Description, Descr…<\/font><\/font><\/font><\/span><\/p>\n

    <\/span>8 DisplayName               <\/span>{DisplayName, DisplayName, Displ…<\/font><\/font><\/font><\/span><\/p>\n

    <\/span>6 Encoding                  <\/span>{Encoding, Encoding, Encoding, E…<\/font><\/font><\/font><\/span><\/p>\n

   <\/span>50 Exclude          <\/span>         <\/span>{Exclude, Exclude, Exclude, Excl…<\/font><\/font><\/font><\/span><\/p>\n

   <\/span>26 Filter                    <\/span>{Filter, Filter, Filter, Filter,…<\/font><\/font><\/font><\/span><\/p>\n

   <\/span>43 Force                     <\/span>{Force, Force, Force, Force, For…<\/font><\/font><\/font><\/span><\/p>\n

   <\/span>49 Include                   <\/span>{Include, Include, Include, Incl…<\/font><\/font><\/font><\/span><\/p>\n

    <\/span>8 Input                     <\/span>{Input, Input, Input, Input, Inp…<\/font><\/font><\/font><\/span><\/p>\n

   <\/span>32 InputObject               <\/span>{InputObject, InputObject, Input…<\/font><\/font><\/font><\/span><\/p>\n

   <\/span>29 Name                      <\/span>{Name, Name, Name, Name, Name, N…<\/font><\/font><\/font><\/span><\/p>\n

   <\/span>47 PassThru                  <\/span>{PassThru, Passthru, PassThru, P…<\/font><\/font><\/font><\/span><\/p>\n

    <\/span>2 Path                      <\/span>{Path, Path}<\/font><\/font><\/font><\/span><\/p>\n

   <\/span>48 Path.MshPath              <\/span>{Path, Path, Path, Path, Path, P…<\/font><\/font><\/font><\/span><\/p>\n

   <\/span>12 Property                  <\/span>{Property, Property, Property, P…<\/font><\/font><\/font><\/span><\/p>\n

    <\/span>8 Property.MshProperty      <\/span>{Property, Property, Property, P…<\/font><\/font><\/font><\/span><\/p>\n

   <\/span>13 Scope                     <\/span>{Scope, Scope, Scope, Scope, Sco…<\/font><\/font><\/font><\/span><\/p>\n

    <\/span>8 ServiceName.Name          <\/span>{ServiceName, ServiceName, Servi…<\/font><\/font><\/font><\/span><\/p>\n

    <\/span>6 Type                      <\/span>{Type, Type, Type, Type, Type, T…<\/font><\/font><\/font><\/span><\/p>\n

   <\/span>12 Value                     <\/span>{Value, Value, Value, Value, Val…<\/font><\/font><\/font><\/span><\/p>\n

   <\/span>52 WhatIf.wi                 <\/span>{WhatIf, WhatIf, WhatIf, WhatIf,…<\/font><\/font><\/font><\/span><\/p>\n

 <\/span><\/p>\n

Here it shows that most parameters don\u2019t have an alias and that PATH uses the alias MSHPATH but that 2 commands don\u2019t use this alias which gives us something to investigate.<\/span><\/p>\n

 <\/span><\/p>\n

 <\/span><\/p>\n

Here is what I hope you\u2019ve learned from this:<\/span><\/p>\n

1)    <\/span><\/span><\/span>Get-Command provides detailed information about anything that can be executed included parameter information for Cmdlets.<\/span><\/p>\n

a.    <\/span><\/span><\/span>Explore how Get-Command returns different data for different types of executables (e.g.
Get-Command ipconfig.exe |fl *
Get-Command prompt |fl *<\/font><\/font><\/font><\/span><\/p>\n

2)    <\/span><\/span><\/span>You can always use WHERE to filter the results of a command but it can be worthwhile investigating whether the command does its own filtering which can sometimes be faster or easier to specify.<\/span><\/p>\n

a.    <\/span><\/span><\/span>Explore how you can leverage the fact that help returns objects so you can craft your own view of help.  <\/span>E.g.
get-help get-* |fl Name,Synopsis
get-help * |where {$_.Synopsis -match “process”} |fl name,Synopsis<\/font><\/strong><\/font><\/font><\/span><\/p>\n

3)    <\/span><\/span><\/span>Commands can have multiple ParameterSets which define valid sets of parameters to perform an operation.<\/span><\/p>\n

a.    <\/span><\/span><\/span>Explore which command has the most ParameterSets.  <\/span>Hint \u2013 use a ScriptBlock parameter on group.<\/span><\/p>\n

4)    <\/span><\/span><\/span>Select can pick properties of an object and\/or expand the elements of a property if that property is a collection.<\/span><\/p>\n

a.    <\/span><\/span><\/span>Explore the power of both selecting properties and expanding properties. Take the example below and explore each step in the pipeline:
MSH> gps |select ProcessName -expand Modules -ea silentlycontinue |group ModuleName |sort -Descend count |select -first 20<\/font><\/strong><\/font><\/font><\/span><\/p>\n

5)    <\/span><\/span><\/span>Group can produce a histogram based upon a property or set of properties and keep the original set of objects.<\/span><\/p>\n

a.    <\/span><\/span><\/span>Explore how you can use group to gain insights into your data.  <\/span>E.g.
dir |group {$_.CreationTime.DayOfWeek} |sort Name
dir |group {$_.CreationTime.DayOfWeek},extension |sort Name<\/font><\/strong><\/font><\/font><\/span><\/p>\n

6)    <\/span><\/span><\/span>ScriptBlock Parameters can be used in any pipelines to dynamically evaluate what data to pass to a parameter.<\/span><\/p>\n

a.    <\/span><\/span><\/span>Explore how you can use ScriptBlock parameters to do funky file tree manipulations.  <\/span>
dir *zip |cpi -destination {$_.fullname.Replace(“jps”,”BackupJps”) } \u2013whatif<\/strong><\/font><\/p>\n

<\/span><\/p>\n

 <\/span><\/p>\n

Jeffrey P. Snover [MSFT]<\/span><\/p>\n

Monad Architect<\/span><\/p>\n

[Edit: Monad has now been renamed to Windows PowerShell. This script or discussion may require slight adjustments before it applies directly to newer builds.<\/i>]<\/p>\n","protected":false},"excerpt":{"rendered":"

We are in the process of cleaning up our Cmdlets and ensuring that they are consistent.  One of the things we want to do is the ensure that we provide Aliases for ParameterNames.  As a general rule, parameternames are not pithy.  That is great for reading scripts but can be a pain during interactive sessions.  […]<\/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-10581","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-powershell"],"acf":[],"blog_post_summary":"

We are in the process of cleaning up our Cmdlets and ensuring that they are consistent.  One of the things we want to do is the ensure that we provide Aliases for ParameterNames.  As a general rule, parameternames are not pithy.  That is great for reading scripts but can be a pain during interactive sessions.  […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/posts\/10581","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=10581"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/posts\/10581\/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=10581"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/categories?post=10581"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/tags?post=10581"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}