{"id":14521,"date":"2011-04-16T00:01:00","date_gmt":"2011-04-16T00:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2011\/04\/16\/create-a-hash-table-with-powershell-aliases-and-definitions\/"},"modified":"2011-04-16T00:01:00","modified_gmt":"2011-04-16T00:01:00","slug":"create-a-hash-table-with-powershell-aliases-and-definitions","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/create-a-hash-table-with-powershell-aliases-and-definitions\/","title":{"rendered":"Create a Hash Table with PowerShell Aliases and Definitions"},"content":{"rendered":"

Summary<\/b>: In preparation for creating a Windows PowerShell ISE add-on to automatically remove aliases, Scripting Guy Ed Wilson builds a hash table with alias definitions.<\/p>\n

Microsoft Scripting Guy, Ed Wilson, here. It has finally happened, I unveiled the last event of the 2011 Windows PowerShell Scripting Games on Friday. Contestants still have a week to deliver their solutions for the remaining events, but the games are drawing to a conclusion. <\/p>\n

The judging criteria for the 2011 Scripting Games are not arbitrary, but they actually represent best practices to incorporate when writing enterprise production scripts. One of those guidelines is to not use Windows PowerShell cmdlet aliases in a script. This causes a few problems for people, because when working interactively from the Windows PowerShell console, the use of aliases is encouraged because it simplifies typing and allows one to get the task accomplished more quickly. <\/p>\n

Because I use the Windows PowerShell console for prototyping commands prior to incorporating them into the Windows PowerShell ISE, I often copy code from the console and paste it into the Windows PowerShell ISE. This causes a dilemma—I like to use aliases in the Windows PowerShell console, but in a script, I should not use aliases. Therefore, when prototyping a command, I have two choices: do not use aliases, or rewrite all my code after I paste it into the Windows PowerShell ISE. Neither choice is great, but until recently those were my two options. <\/p>\n

While I was grading some of the scripts for the 2011 Scripting Games, a third option to the problem of aliases came to me: Write a script and have it replace all aliases with the full cmdlet names. <\/p>\n

Today’s blog is the first of a series of four that will discuss the parts of my solution to the problem of working with aliases. In this blog, I want to create a hash table and populate it with all of the available aliases. The code that accomplishes this task is shown here.<\/p>\n

\n
New-HashTableWithAliases.ps1<\/h5>\n<\/blockquote>\n
\n

Get-Alias |<\/span><\/span><\/span><\/p>\n

 <\/span><\/span>Select-object name, definition | <\/span><\/span><\/span><\/span><\/p>\n

 <\/span><\/span>Foreach-object -begin {$a = @{} } `<\/span><\/span><\/span><\/span><\/p>\n

                <\/span><\/span>-process { $a.add($_.name,$_.definition)} `<\/span><\/span><\/span><\/span><\/p>\n

                <\/span><\/span>-end {$a}<\/span><\/span><\/span><\/span><\/span><\/p>\n<\/blockquote>\n

The Get-Alias<\/b> cmdlet returns a list of aliases and their associated definitions. Each alias that is returned by this cmdlet is an instance of an aliasinfo<\/b> object. The members of that object are shown here.<\/p>\n

\n

PS C:\\> Get-Alias | Get-Member<\/span><\/span><\/span><\/p>\n

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

TypeName: System.Management.Automation.AliasInfo<\/span><\/span><\/span><\/span><\/p>\n

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

Name                <\/span>MemberType     <\/span>Definition<\/span><\/span><\/span><\/p>\n

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

Equals              <\/span>Method         <\/span>bool Equals(System.Object obj)<\/span><\/span><\/span><\/p>\n

GetHashCode         <\/span>Method         <\/span>int GetHashCode()<\/span><\/span><\/span><\/p>\n

GetType             <\/span>Method         <\/span>type GetType()<\/span><\/span><\/span><\/p>\n

ToString            <\/span>Method         <\/span>string ToString()<\/span><\/span><\/span><\/p>\n

CommandType         <\/span>Property       <\/span>System.Management.Automation.CommandTypes Comm…<\/span><\/span><\/span><\/p>\n

Definition          <\/span>Property       <\/span>System.String Definition {get;}<\/span><\/span><\/span><\/p>\n

Description         <\/span>Property       <\/span>System.String Description {get;set;}<\/span><\/span><\/span><\/p>\n

Module              <\/span>Property       <\/span>System.Management.Automation.PSModuleInfo Modu…<\/span><\/span><\/span><\/p>\n

ModuleName          <\/span>Property       <\/span>System.String ModuleName {get;}<\/span><\/span><\/span><\/p>\n

Name                <\/span>Property       <\/span>System.String Name {get;}<\/span><\/span><\/span><\/p>\n

Options             <\/span>Property       <\/span>System.Management.Automation.ScopedItemOptions…<\/span><\/span><\/span><\/p>\n

OutputType          <\/span>Property       <\/span>System.Collections.ObjectModel.ReadOnlyCollect…<\/span><\/span><\/span><\/p>\n

Parameters          <\/span>Property       <\/span>System.Collections.Generic.Dictionary`2[[Syste…<\/span><\/span><\/span><\/p>\n

ParameterSets       <\/span>Property       <\/span>System.Collections.ObjectModel.ReadOnlyCollect…<\/span><\/span><\/span><\/p>\n

ReferencedCommand   <\/span>Property       <\/span>System.Management.Automation.CommandInfo Refer…<\/span><\/span><\/span><\/p>\n

ResolvedCommand     <\/span>Property       <\/span>System.Management.Automation.CommandInfo Resol…<\/span><\/span><\/span><\/p>\n

Visibility          <\/span>Property       <\/span>System.Management.Automation.SessionStateEntry…<\/span><\/span><\/span><\/p>\n

HelpUri             <\/span>ScriptProperty System.Object HelpUri {get=try…<\/span><\/span><\/span><\/p>\n

ResolvedCommandName ScriptProperty System.Object ResolvedCommandName {get=$this.R…<\/span><\/span><\/span><\/p>\n<\/blockquote>\n

There are two properties from the aliasinfo<\/b> object that I want to retrieve: the name<\/b> and the definition<\/b>. The name<\/b> property is the actual alias itself; the definition<\/b> property is the full cmdlet name that resolves to the alias. The following code illustrates this concept by using the Get-Alias<\/b> cmdlet to retrieve the alias named gps<\/b>. <\/p>\n

\n

PS C:\\> Get-Alias gps<\/span><\/span><\/span><\/p>\n

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

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

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

Alias           <\/span>gps                                <\/span>Get-Process<\/span><\/span><\/span><\/p>\n<\/blockquote>\n

To retrieve only the name<\/b> and the definition<\/b> from all of the aliases, I use the code seen here.<\/p>\n

\n

Get-Alias |<\/span><\/span><\/span><\/p>\n

 <\/span><\/span>Select-Object name, definition<\/span><\/span><\/span><\/span><\/p>\n<\/blockquote>\n

The command to retrieve aliases and definitions and the associated output are shown here.<\/p>\n

\"Image<\/a><\/p>\n

When I have the aliases and their associated definition, I create a hash table for storage. The name will be the key property because all aliases have to be unique. The definition will be the value that is associated with the key because there could be several aliases for a single cmdlet. <\/p>\n

To create an empty hash table, I use the syntax shown here where I store the empty hash table in the $a<\/b> variable. <\/i>I only need to perform this action once, so I place this command in the begin portion of the Foreach-Object<\/b> cmdlet. <\/p>\n

\n

-begin {$a = @{} }}<\/span><\/span><\/span><\/p>\n<\/blockquote>\n

To add to the hash table, I use the add<\/b> method. The first item is the key, and the second item is the value. In this example, I am adding the name as the key and the definition as the value. I will add each alias and its associated definition as they flow through the Foreach-Object<\/b> cmdlet. Therefore, this section goes into the process portion of the command. Here is that portion of the script. <\/p>\n

\n

-process { $a.add($_.name,$_.definition)}<\/span><\/span><\/span><\/p>\n<\/blockquote>\n

The last thing I do here, is to display the contents of the hash table that is stored in the $a<\/b> variable. This action will occur after everything else has completed; and therefore, it appears in the end portion of the ForEach-Object<\/b> cmdlet.<\/p>\n

\n

-end {$a}<\/span><\/span><\/span><\/p>\n<\/blockquote>\n

The script and its associated output are shown in the following image.<\/p>\n

\"Image<\/a><\/p>\n

I invite you to follow me on Twitter<\/a> and Facebook<\/a>. If you have any questions, send email to me at scripter@microsoft.com<\/a>, or post your questions on the Official Scripting Guys Forum<\/a>. See you tomorrow. Until then, peace.<\/p>\n

Ed Wilson, Microsoft Scripting Guy<\/b><\/p>\n","protected":false},"excerpt":{"rendered":"

Summary: In preparation for creating a Windows PowerShell ISE add-on to automatically remove aliases, Scripting Guy Ed Wilson builds a hash table with alias definitions. Microsoft Scripting Guy, Ed Wilson, here. It has finally happened, I unveiled the last event of the 2011 Windows PowerShell Scripting Games on Friday. Contestants still have a week to […]<\/p>\n","protected":false},"author":595,"featured_media":87096,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[18,3,4,45],"class_list":["post-14521","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-arrays-hash-tables-and-dictionary-objects","tag-scripting-guy","tag-scripting-techniques","tag-windows-powershell"],"acf":[],"blog_post_summary":"

Summary: In preparation for creating a Windows PowerShell ISE add-on to automatically remove aliases, Scripting Guy Ed Wilson builds a hash table with alias definitions. Microsoft Scripting Guy, Ed Wilson, here. It has finally happened, I unveiled the last event of the 2011 Windows PowerShell Scripting Games on Friday. Contestants still have a week to […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/14521","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/users\/595"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/comments?post=14521"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/14521\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media\/87096"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media?parent=14521"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=14521"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=14521"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}