{"id":4055,"date":"2013-03-07T00:01:00","date_gmt":"2013-03-07T00:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2013\/03\/07\/working-with-the-powershell-alias-drive\/"},"modified":"2013-03-07T00:01:00","modified_gmt":"2013-03-07T00:01:00","slug":"working-with-the-powershell-alias-drive","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/working-with-the-powershell-alias-drive\/","title":{"rendered":"Working with the PowerShell Alias: Drive"},"content":{"rendered":"

Summary<\/strong>: Microsoft Scripting Guy, Ed Wilson, talks about how to work with the Windows PowerShell Alias: drive.<\/p>\n

\"Hey, Hey, Scripting Guy! Can you tell me what an Alias: drive is? Is it anything like a virtual drive?<\/p>\n

—EC<\/p>\n

\"Hey, Hello EC,<\/p>\n

Microsoft Scripting Guy, Ed Wilson, is here. Today we have the Windows PowerShell User Group meeting in Charlotte, North Carolina at the Microsoft office. The Scripting Wife has been talking about the meeting all week, and there are several new people signed up to attend. It will be fun. We are planning to do another miniscripting games event. Those are always fun. It is not too late to sign up. You can find details on the Charlotte PowerShell Users Group site<\/a>.<\/p>\n

EC, the Alias: drive is a virtual drive—just not in the way you are probably thinking.<\/p>\n

What is the Alias: drive?<\/h2>\n

The Alias: drive is a drive that is created by the Windows PowerShell provider subsystem to expose information about aliases in a way that allows you to interact with aliases in the same way you would work with the file system. This sounds more confusing than it really is. For example, to get to the Alias: drive, I use the Set-Location<\/strong> cmdlet (or I can use the alias cd<\/strong> <\/em>or sl<\/strong>). This is shown here.<\/p>\n

PS C:\\> cd alias:<\/p>\n

PS Alias:\\><\/p>\n

When I am on the Alias: drive, I can use the Get-ChildItem<\/strong> cmdlet (or the alias dir<\/strong> <\/em>or ls<\/strong>) <\/em>to obtain a list of all the aliases that are defined on my computer as shown here.<\/p>\n

PS Alias:\\> dir<\/p>\n

The command and its associated output are shown here.<\/p>\n

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

To examine all of the properties of a specific alias, use the Get-Item<\/strong> cmdlet to return information about the alias. Then pipe the results to the Format-List<\/strong> cmdlet and choose the * wildcard for the properties. This command is shown here.<\/p>\n

PS Alias:\\> Get-Item r | fl *<\/p>\n

The command and the output associated with the command are shown in the image that follows.<\/p>\n

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

When attempting to understand more about aliases, the crucial things to pay attention to are the Definition<\/strong> and the Options<\/strong> properties.<\/p>\n

Note   <\/strong>The command that the alias resolves to is actually available in a number of properties. These properties are ResolvedCommandName<\/strong>, ReferencedCommand<\/strong>, ResolvedCommand<\/strong>, and Definition<\/strong>.<\/p>\n

To find all of the aliases that are defined for a particular cmdlet (one that I use on a regular basis so that it would pay great dividends on reducing typing workload), I pipe the results of the Get-ChildItem<\/strong> cmdlet on the Alias: drive and filter on the Definition<\/strong> property for the cmdlet. This technique is shown here (dir<\/strong> is an alias for Get-ChildItem<\/strong>).<\/p>\n

PS Alias:\\> dir | ? definition -eq ‘get-childitem’<\/p>\n

 <\/p>\n

CommandType     Name                                               ModuleName<\/p>\n

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

Alias           dir -> Get-ChildItem<\/p>\n

Alias           gci -> Get-ChildItem<\/p>\n

Alias           ls -> Get-ChildItem<\/p>\n

Looking at alias options<\/h2>\n

Several cmdlets have ReadOnly aliases. These appear when I look at the Options<\/strong> property. All of the ReadOnly aliases are also defined as available to all scopes within Windows PowerShell. Some aliases are not ReadOnly, but most of the not ReadOnly aliases are defined for all scopes. On my computer, three aliases have no options. Because working with the Alias: drive returns objects, this type of information is really easy to obtain. I use the Get-Childitem<\/strong> cmdlet to return all aliases from the Alias: drive. I pipe the resulting AliasInfo<\/strong> objects to the Sort<\/strong> object cmdlet, and I sort on the Options<\/strong> property. I then group the objects by piping to the Group-Object<\/strong> cmdlet. The command and output associated with the command are shown here.<\/p>\n

PS Alias:\\> dir | sort options | group options<\/p>\n

 <\/p>\n

Count Name                      Group<\/p>\n

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

    3 None                      {ep, sls, gmh}<\/p>\n

   48 AllScope                  {exsn, set, popd, ipsn…}<\/p>\n

   99 ReadOnly, AllScope        {rdr, ni, nv, npssc…}<\/p>\n

Note<\/strong>   When working with the Alias: drive, it does not automatically import modules. Therefore, the results are limited to only the modules that I have imported.<\/p>\n

If I want to know about all of my modules and cmdlets, I need to first import all of the modules. This command and output are shown here.<\/p>\n

PS Alias:\\> gmo -ListAvailable | ipmo<\/p>\n

PS Alias:\\> dir | sort options | group options<\/p>\n

 <\/p>\n

Count Name                      Group<\/p>\n

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

   72 None                      {Get-ProvisionedAppxPackage, gfsd, Get-GPPermissi…<\/p>\n

   48 AllScope                  {lp, rd, ren, rjb…}<\/p>\n

  111 ReadOnly, AllScope        {rcms, rcsn, tee, swmi…}<\/p>\n

To delete an alias that is not marked as ReadOnly, all I need to do is use the Remove-Ite<\/strong>m cmdlet. When I do this, the Get-Item<\/strong> cmdlet informs me that I was successful. These commands are shown here.<\/p>\n

PS Alias:\\> Remove-Item lp<\/p>\n

PS Alias:\\> Get-Item lp<\/p>\n

Get-Item : Cannot find path ‘Alias:\\lp’ because it does not exist.<\/p>\n

At line:1 char:1<\/p>\n

+ Get-Item lp<\/p>\n

+ ~~~~~~~~~~~<\/p>\n

    + CategoryInfo          : ObjectNotFound: (Alias:\\lp:String) [Get-Item], ItemNo<\/p>\n

   tFoundException<\/p>\n

    + FullyQualifiedErrorId : PathNotFound,Microsoft.PowerShell.Commands.GetItemCom<\/p>\n

   Mand<\/p>\n

If I attempt to delete a ReadOnly alias, an error arises as shown here.<\/p>\n

PS Alias:\\> Remove-Item rcms<\/p>\n

Remove-Item : Alias was not removed because alias rcms is constant or read-only.<\/p>\n

At line:1 char:1<\/p>\n

+ Remove-Item rcms<\/p>\n

+ ~~~~~~~~~~~~~~~~<\/p>\n

    + CategoryInfo          : WriteError: (rcms:String) [Remove-Item], SessionState<\/p>\n

   UnauthorizedAccessException<\/p>\n

    + FullyQualifiedErrorId : AliasNotRemovable,Microsoft.PowerShell.Commands.Remov<\/p>\n

   eItemCommand<\/p>\n

However, if I use the –force<\/strong> <\/em>switched parameter when I attempt to remove the ReadOnly alias, the command succeeds. This is shown here.<\/p>\n

PS Alias:\\> Remove-Item rcms -Force<\/p>\n

PS Alias:\\> Get-Alias rcms<\/p>\n

Get-Alias : This command cannot find a matching alias because an alias with the<\/p>\n

name ‘rcms’ does not exist.<\/p>\n

At line:1 char:1<\/p>\n

+ Get-Alias rcms<\/p>\n

+ ~~~~~~~~~~~~~~<\/p>\n

    + CategoryInfo          : ObjectNotFound: (rcms:String) [Get-Alias], ItemNotFou<\/p>\n

   ndException<\/p>\n

    + FullyQualifiedErrorId : ItemNotFoundException,Microsoft.PowerShell.Commands.G<\/p>\n

   etAliasCommand<\/p>\n

EC, that is all there is to using the Alias: drive. Windows PowerShell Provider Week will continue tomorrow when I will talk about the Variable: drive.<\/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<\/strong> <\/p>\n","protected":false},"excerpt":{"rendered":"

Summary: Microsoft Scripting Guy, Ed Wilson, talks about how to work with the Windows PowerShell Alias: drive.  Hey, Scripting Guy! Can you tell me what an Alias: drive is? Is it anything like a virtual drive? —EC  Hello EC, Microsoft Scripting Guy, Ed Wilson, is here. Today we have the Windows PowerShell User Group meeting […]<\/p>\n","protected":false},"author":596,"featured_media":87096,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[415,3,4,45],"class_list":["post-4055","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-psproviders","tag-scripting-guy","tag-scripting-techniques","tag-windows-powershell"],"acf":[],"blog_post_summary":"

Summary: Microsoft Scripting Guy, Ed Wilson, talks about how to work with the Windows PowerShell Alias: drive.  Hey, Scripting Guy! Can you tell me what an Alias: drive is? Is it anything like a virtual drive? —EC  Hello EC, Microsoft Scripting Guy, Ed Wilson, is here. Today we have the Windows PowerShell User Group meeting […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/4055","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\/596"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/comments?post=4055"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/4055\/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=4055"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=4055"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=4055"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}