Push-Location - PowerShell


 

Adds the current location to the top of a list of locations (a "stack"). (Push-Location)

   

# NAME
Push-Location

# SYNOPSIS
Adds the current location to the top of a list of locations (a "stack").

# SYNTAX
Push-Location [[-LiteralPath] <string>] [-PassThru] [-StackName <string>] [-UseTransaction] [<CommonParameters>]

Push-Location [[-Path] <string>] [-PassThru] [-StackName <string>] [-UseTransaction] [<CommonParameters>]

# DESCRIPTION
The Push-Location cmdlet adds ("pushes") the current location to the top of a list of locations, called a "stack." You can push the current location onto a default stack or onto a stack that you create. If you specify a path, Push-Location pushes the current location onto the stack and then changes the current location to the location specified by the path. You cannot push a location onto the stack unless it is the current location.

# PARAMETERS
-LiteralPath <string>
Specifies the path to the new location. Unlike the Path parameter, the value of the LiteralPath parameter is used exactly as it is typed. No characters are interpreted as wildcards. If the path includes escape characters, enclose it in single quotation marks. Single quotation marks tell Windows PowerShell not to interpret any characters as escape sequences.

Required? false
Position? 1
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-PassThru [<SwitchParameter>]
Passes an object representing the location to the pipeline. By default, this cmdlet does not generate any output.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Path <string>
Changes your location to the location specified by this path after it adds (pushes) the current location onto the top of the stack. Enter a path to any location whose provider supports this cmdlet. Wildcards are permitted. The parameter name ("Path") is optional.

Required? false
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false

-StackName <string>
Specifies the name of a stack. The current location is pushed onto this stack, and this stack becomes the current stack. If the stack does not yet exist, it is created.

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-UseTransaction [<SwitchParameter>]
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

<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".

# INPUTS
System.String
You can pipe a string that contains a path (but not a literal path) to Push-Location.

# OUTPUTS
None or System.Management.Automation.PathInfo
When you use the PassThru parameter, Push-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 Push-Location by its built-in alias, "pushd". For more information, see about_Aliases.

A "stack" is a "last-in, first-out" (LIFO) data structure. It is like a vertical list in which only the top item is accessible. You can add ("push") items only to the top of the stack, and you can retrieve ("pop") items only from the top of the stack. To get to items below the top, you must retrieve all the items above.

The Push-Location cmdlet is designed to work with the data exposed by any provider. To list the providers available in your session, type "Get-PSProvider". For more information, see about_Providers.

# EXAMPLE 1

C:\PS>push-location C:\Windows

# Description
-----------
This command pushes the current location onto the default stack and then changes the location to C:\Windows.

# EXAMPLE 2

C:\PS>push-location HKLM:\Software\Policies -stackname RegFunction

# Description
-----------
This command pushes the current location onto the RegFunction stack and changes the current location to the HKLM:\Software\Policies location. This command shows that you can use Push-Location with the Windows PowerShell registry provider.

# EXAMPLE 3

C:\PS>push-location

# Description
-----------
This command pushes the current location onto the default stack.

# EXAMPLE 4

C:\PS>push-location ~ -stackname Stack2

# Description
-----------
This command pushes the current location onto a new stack named Stack2 and then changes the current location to the home directory (%USERPROFILE%), which is represented in the command by the tilde symbol (~) or $home. The Stack2 stack then becomes the current stack.

RELATED LINKS
Online version: http://go.microsoft.com/fwlink/?LinkID=113370
about_Providers
Pop-Location
Set-Location
Get-Location

C:\Windows>powershell get-help Pop-Location -full

ColorConsole [Version 1.7.1000] PowerShell 2.0-Export
Microsoft Windows [Version 6.1.7600]
Copyright (c) 2014 Microsoft Corporation.

OS: Windows 10, 8.1, 8, 7, Vista / Windows Server 2016, 2012, 2008
»»»» ColorConsole








Windows-10





Windows-10

... facebook.de
... Windows-10 FAQ
... Windows-10 Info


Become a Sponsor
... Your button here?





PowerShell: Adds the current location to the top of a list of locations (a "stack").

HTTP: ... PS_Windows/en/Push-Location.htm
0.171
14427

Download Windows-8 / 8.1 version for testing?

 /

Select directory from List View enable, turn off?

 /

Commando line to see the WLAN info on Windows 10!

 /

Open a second drive of directory in new window (Tab)?

 /

How can I set the Windows turn off timer / shut down (10 / 8.1 / 7)?

 /

Windows 7/10 Schatten-Kopien und System-Wiederherstellungs-Punkte Unterschiede?

 /

How to add to Explorer context menu (Windows 7, 8.1, 10)?

 /

Can not drag In Explorer View at Windows Admin Mode!

 /

Verwenden von Batchdatei Datei zum Starten von mehreren Programmen!

 /

Desktop shortcut for the calculator on the Windows 10 desktop!

 /

Quick Text Paste Befehle und Platzhalter!

 /

Command prompt Save program parameter arguments as favorites!

 /