{"id":6531,"date":"2015-04-21T00:01:00","date_gmt":"2015-04-21T00:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2015\/04\/21\/location-location-location-in-powershell\/"},"modified":"2019-02-18T10:29:49","modified_gmt":"2019-02-18T17:29:49","slug":"location-location-location-in-powershell","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/location-location-location-in-powershell\/","title":{"rendered":"Location, Location, Location in PowerShell"},"content":{"rendered":"

Summary<\/b>: Microsoft Scripting Guy, Ed Wilson, talks about managing locations in Windows PowerShell.<\/span><\/p>\n

\"Hey, Hey, Scripting Guy! I don’t understand what is the big deal with Get-Location<\/b>. I mean, I can look and see where I am at, so why do I need Get-Location<\/b>? For that matter, what are a PushD<\/b> and a PopD<\/b>? It says it has something to do with a stack, but I don’t know where that stack is, or even what a stack is. Can you help?<\/p>\n

—DW<\/p>\n

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

Microsoft Scripting Guy, Ed Wilson, is here. The weather in Charlotte finally cleared up. It has been rather cold and wet the past couple days. This is kind of bad because the Windows PowerShell Summit is taking place this week in Charlotte, and we have had nice weather for the past week or so—so I was hoping my friends from other places would see the city in a better light. In fact, Windows PowerShell MVP, Sean Kearney, posted this picture on his Facebook page:<\/p>\n

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

Oh, well. Like I said, it is clearing up, and it should be lovely for the next few days.<\/p>\n

The thing that is important about location in Windows PowerShell is that the location can be anywhere. Remember yesterday's post, Find and Use Windows PowerShell Providers<\/a>? Each of those providers exposes Windows PowerShell drives. So the location may be drive C of your file system—but it could just as easily be the Alias:<\/b> drive that exposes Windows PowerShell aliases and their associated values.<\/p>\n

As you might expect, the Get-Location<\/b> cmdlet returns an object. This might not be a surprise because everything in Windows PowerShell is an object. And just like most other objects, it returns default information. But there is also additional information available. As shown here, when I type Get-Location<\/b>, by default, it returns the path:<\/p>\n

PS C:\\fso2> Get-Location<\/p>\n

Path                                                                                          <\/p>\n

—-                                                                                           <\/p>\n

C:\\fso2          <\/p>\n

This information may seem a bit redundant. I mean, I can look at my Windows PowerShell prompt, and if it is in the default configuration, it already shows me my location. But by piping the object that is returned by the Get-Location<\/b> cmdlet to the Get-Member<\/b> cmdlet, I can see that I actually have a PathInfo<\/b> object, and that there is more than only path information available. This is shown here:<\/p>\n

PS C:\\fso2> Get-Location | gm<\/p>\n

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

Name     MemberType    Definition                                              <\/p>\n

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

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

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

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

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

Drive        Property   System.Management.Automation.PSDriveInfo Drive {get;}   <\/p>\n

Path         Property   string Path {get;}                                      <\/p>\n

Provider     Property   System.Management.Automation.ProviderInfo Provider {get;}<\/p>\n

ProviderPath Property   string ProviderPath {get;}  <\/p>\n

The easiest way to see the additional properties is to pipe the object returned by Get-Location<\/b> to the Format-List<\/b> cmdlet and select all of the properties by using the asterisk wildcard character. This command and its associated output are shown here:<\/p>\n

PS C:\\fso2> Get-Location | Format-List *<\/p>\n

Drive        : C<\/p>\n

Provider     : Microsoft.PowerShell.Core\\FileSystem<\/p>\n

ProviderPath : C:\\fso2<\/p>\n

Path         : C:\\fso2<\/p>\n

To change my current location, I use the Set-Location<\/b> cmdlet. This is a basic command. In fact, there are three aliases created by default for this command:<\/p>\n

PS C:\\> Get-Alias -Definition set-location<\/p>\n

CommandType     Name         ModuleName                 <\/p>\n

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

Alias           cd -> Set-Location                                                             <\/p>\n

Alias           chdir -> Set-Location                                                         <\/p>\n

Alias           sl -> Set-Location                                         <\/p>\n

If I want to change my location to a particular folder, I can use any of the above aliases or type the complete cmdlet name. To go to a particular folder, I can use the command that is shown here:<\/p>\n

PS C:\\> sl c:\\fso1<\/p>\n

But if I want to return to the root of drive C, I must follow it with a backslash. For example, if I just use sl c:<\/b>, it does produce an error, but it does not move to the root drive. This is shown here:<\/p>\n

PS C:\\fso1> sl c:<\/p>\n

PS C:\\fso1> sl c:\\<\/p>\n

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

What is a stack?<\/h3>\n

You can think of a stack as simply a pile—like the following pile of books:<\/p>\n

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

If I want to retrieve a book from the pile, in general, I will remove the book from the top of the pile (or stack). This book is the last one that I added to the stack. In computer terms, this is referred to as "last in, first out" (LIFO). In book pile terms, it is referred to as not making a mess.<\/p>\n

So, a stack is simply a collection of elements (or items) that can be of any type. For example, I could have a stack of DVDs or stack of CDs in addition to my stack of books. My book stack has two methods: add and remove. In computer terms, a stack has two methods: push and pop. An item is pushed to the stack or popped off the stack. In Windows PowerShell, there are two associated cmdlets, Push-Location<\/b> and Pop-Location<\/b>. They also have aliases as shown here:<\/p>\n

PS C:\\> Get-Alias pushd, popd<\/p>\n

CommandType     Name        ModuleName                 <\/p>\n

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

Alias           pushd -> Push-Location                                                        <\/p>\n

Alias           popd -> Pop-Location                                                           <\/p>\n

Location information is therefore stored in a stack. By default, this location stack is not named. So why do I care about this stuff? Well, certainly, I can CD<\/b> around or SL<\/b> around. But this can begin to be a lot of typing. Here is an example:<\/p>\n

PS C:\\> sl C:\\fso<\/p>\n

PS C:\\fso> sl c:\\<\/p>\n

PS C:\\> sl E:\\Data\\ScriptingGuys\\2015\\HSG_4_20_15<\/p>\n

PS E:\\Data\\ScriptingGuys\\2015\\HSG_4_20_15> sl 'C:\\Users\\ed\\SkyDrive\\Pictures\\Camera Roll'<\/p>\n

PS C:\\Users\\ed\\SkyDrive\\Pictures\\Camera Roll> sl E:\\Data\\BookDOcs\\PS5_sbs_book\\Scripts\\Scripts_ch12<\/p>\n

PS E:\\Data\\BookDOcs\\PS5_sbs_book\\Scripts\\Scripts_ch12> <\/p>\n

Unfortunately, even when I remember to use Tab completion and IntelliSense in the Windows PowerShell ISE, this rapidly becomes unwieldy. One of the issues with multiterabyte drives is that the file system structure seems to become complex, and the paths go on and on and on. This makes working from the command line (even from Windows PowerShell) a major pain.<\/p>\n

It also can become a source of errors—especially when using Tab completion. When the folder names begin to look the same (such as my weekly folders for the Hey, Scripting Guy! Blog), you really need to pay attention to what you are doing. And anytime you have to rely on paying attention, you are asking for trouble. (As an aside, on MCSE exams, anytime the answer contains “… and instruct the user how to properly…”—that is not the right answer!)<\/p>\n

So, what is the right answer? Well, in this case, it involves using Push-Location<\/b> and Pop-Location<\/b> (or PushD<\/b> and PopD<\/b> as the alias names).<\/p>\n

PS C:\\> pushd C:\\fso<\/p>\n

PS C:\\fso> pushd c:\\<\/p>\n

PS C:\\> pushd E:\\Data\\ScriptingGuys\\2015\\HSG_4_20_15<\/p>\n

PS E:\\Data\\ScriptingGuys\\2015\\HSG_4_20_15> pushd 'C:\\Users\\ed\\SkyDrive\\Pictures\\Camera Roll'<\/p>\n

PS C:\\Users\\ed\\SkyDrive\\Pictures\\Camera Roll> pushd E:\\Data\\BookDOcs\\PS5_sbs_book\\Scripts\\Scripts_ch12<\/p>\n

PS E:\\Data\\BookDOcs\\PS5_sbs_book\\Scripts\\Scripts_ch12> <\/p>\n

If I want to see where I have been, I can use the Get-Location<\/b> cmdlet, but I also specify –Stack<\/b>. This causes the cmdlet to return the locations stored on the current stack (the default stack). Because I have not named a stack, I am using my default unnamed stack. This makes it easy, because I now use –Stack<\/b> and it returns what I want. This is shown here:<\/p>\n

PS E:\\Data\\BookDOcs\\PS5_sbs_book\\Scripts\\Scripts_ch12> Get-Location -Stack<\/p>\n

Path                                                                                                           <\/p>\n

—-                                                                                                            <\/p>\n

C:\\Users\\ed\\SkyDrive\\Pictures\\Camera Roll                                                                      <\/p>\n

E:\\Data\\ScriptingGuys\\2015\\HSG_4_20_15                                                                          <\/p>\n

C:\\                                                                                                            <\/p>\n

C:\\fso                                                                                                          <\/p>\n

C:\\        <\/p>\n

Remember that a stack is LIFO. This means that if I begin to pop items off the stack (by using the alias PopD<\/b> for Pop-Location<\/b>), I should return to the last place I was. This is shown here:<\/p>\n

PS E:\\Data\\BookDOcs\\PS5_sbs_book\\Scripts\\Scripts_ch12> popd<\/p>\n

PS C:\\Users\\ed\\SkyDrive\\Pictures\\Camera Roll> <\/p>\n

What does the stack look like? I use the Up arrow and retrieve the Get-Location –Stack<\/b> command. As shown here, the content of the default location stack now appears:<\/p>\n

PS C:\\Users\\ed\\SkyDrive\\Pictures\\Camera Roll> Get-Location -Stack <\/span><\/p>\n

Path                                                                                                           <\/p>\n

—-                                                                                                            <\/p>\n

E:\\Data\\ScriptingGuys\\2015\\HSG_4_20_15                                                                         <\/p>\n

C:\\                                                                                                            <\/p>\n

C:\\fso                                                                                                         <\/p>\n

C:\\   <\/p>\n

Now if I use PopD<\/b>, I will go to the Scripting Guy folder. To get a feel for the way it works, I once again check the stack all the way until the stack is empty. This is shown here:<\/p>\n

PS C:\\Users\\ed\\SkyDrive\\Pictures\\Camera Roll> popd<\/p>\n

PS E:\\Data\\ScriptingGuys\\2015\\HSG_4_20_15> Get-Location -Stack<\/p>\n

Path                                                                                                           <\/p>\n

—-                                                                                                           <\/p>\n

C:\\                                                                                                            <\/p>\n

C:\\fso                                                                                                         <\/p>\n

C:\\                                                                                                             <\/p>\n

PS E:\\Data\\ScriptingGuys\\2015\\HSG_4_20_15> popd<\/p>\n

PS C:\\> Get-Location -Stack<\/p>\n

Path                                                                                                            <\/p>\n

—-                                                                                                           <\/p>\n

C:\\fso                                                                                                         <\/p>\n

C:\\                                                                                                             <\/p>\n

PS C:\\> popd<\/p>\n

PS C:\\fso> Get-Location -Stack<\/p>\n

Path                                                                                                           <\/p>\n

—-                                                                                                           <\/p>\n

C:\\                                                                                                             <\/p>\n

PS C:\\fso> popd<\/p>\n

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

Now that I am back to the root drive, I check the stack. It is empty.<\/p>\n

PS C:\\> Get-Location -Stack<\/p>\n

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

DW, that is all there is to using location in Windows PowerShell. Provider Week will continue tomorrow when I will talk about more cool stuff.<\/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> <\/span><\/p>\n","protected":false},"excerpt":{"rendered":"

Summary: Microsoft Scripting Guy, Ed Wilson, talks about managing locations in Windows PowerShell.  Hey, Scripting Guy! I don’t understand what is the big deal with Get-Location. I mean, I can look and see where I am at, so why do I need Get-Location? For that matter, what are a PushD and a PopD? It says […]<\/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":[51,3,4,45],"class_list":["post-6531","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-getting-started","tag-scripting-guy","tag-scripting-techniques","tag-windows-powershell"],"acf":[],"blog_post_summary":"

Summary: Microsoft Scripting Guy, Ed Wilson, talks about managing locations in Windows PowerShell.  Hey, Scripting Guy! I don’t understand what is the big deal with Get-Location. I mean, I can look and see where I am at, so why do I need Get-Location? For that matter, what are a PushD and a PopD? It says […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/6531","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=6531"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/6531\/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=6531"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=6531"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=6531"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}