![]() NAME Pop-Location SYNOPSIS Changes the current location to the location most recently pushed onto the stack. You can pop the location from the default stack or from a stack that you create by using the Push-Location cmdlet. SYNTAX Pop-Location [-PassThru] [-StackName DESCRIPTION The Pop-Location cmdlet changes the current location to the location most recently pushed onto the stack by using t he Push-Location cmdlet. You can pop a location from the default stack or from a stack that you create by using a P ush-Location command. PARAMETERS -PassThru [ Passes an object representing the location to the pipeline. By default, this cmdlet does not generate any outpu t. Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false -StackName Specifies an alternate stack. Pop-Location pops the most recently added location from this stack. This stack th en becomes the current stack. Required? false Position? named Default value Accept pipeline input? true (ByPropertyName) Accept wildcard characters? false -UseTransaction [ Includes the command in the active transaction. This parameter is valid only when a transaction is in progress. For more information, see about_Transactions. Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer and OutVariable. For more information, type, "get-help about_commonparameters". INPUTS None You cannot pipe input to Pop-Location. OUTPUTS None or System.Management.Automation.PathInfo When you use the PassThru parameter, Pop-Location generates a System.Management.Automation.PathInfo object that represents the location. Otherwise, this cmdlet does not generate any output. NOTES You can also refer to Pop-Location by its built-in alias, "popd". For more information, see about_Aliases. The Pop-Location cmdlet is designed to work with the data exposed by any provider. To list the providers availa ble in your session, type "Get-PSProvider". For more information, see about_Providers. -------------------------- EXAMPLE 1 -------------------------- C:\PS>pop-location Description ----------- This command changes your location to the location most recently added to the current stack. -------------------------- EXAMPLE 2 -------------------------- C:\PS>pop-location -stackname Stack2 Description ----------- This command changes your location to the location most recently added to the Stack2 stack. -------------------------- EXAMPLE 3 -------------------------- C:\PS>pushd HKLM:\Software\Microsoft\PowerShell pushd Cert:\LocalMachine\TrustedPublisher popd popd PS C:\> push-location HKLM:\Software\Microsoft\PowerShell PS HKLM:\Software\Microsoft\PowerShell> push-location Cert:\LocalMachine\TrustedPublisher PS cert:\LocalMachine\TrustedPublisher> popd PS HKLM:\Software\Microsoft\PowerShell> popd PS C:\ps-test> Description ----------- These commands use the Push-Location and Pop-Location cmdlets to move between locations supported by different Wind ows PowerShell providers. The commands use the "pushd" alias for Push-Location and the "popd" alias for Pop-Locatio n. The first command pushes the current file system location onto the stack and moves to the HKLM drive supported by t he Windows PowerShell Registry provider. The second command pushes the registry location onto the stack and moves t o a location supported by the Windows PowerShell certificate provider. The last two commands pop those locations off the stack. The first "popd" command returns to the Registry: drive, a nd the second command returns to the file system drive. RELATED LINKS Online version: http://go.microsoft.com/fwlink/?LinkID=113369 about_Providers Push-Location Set-Location Get-Location |