Sdílet prostřednictvím

Push-Location

Modul:
Microsoft.PowerShell.Management Module

Přidá aktuální umístění do horní části zásobníku umístění.

Syntax

Path (Výchozí) 

Push-Location
    [[-Path] <String>]
    [-PassThru]
    [-StackName <String>]
    [<CommonParameters>]

LiteralPath 

Push-Location
    [-LiteralPath <String>]
    [-PassThru]
    [-StackName <String>]
    [<CommonParameters>]

Description

Rutina Push-Location přidá ("pushes") aktuální umístění do zásobníku umístění. Pokud zadáte cestu, Push-Location nasdílí aktuální umístění do zásobníku umístění a pak změní aktuální umístění na umístění určené cestou. K získání umístění ze zásobníku umístění můžete použít rutinu Pop-Location.

Rutina Push-Location ve výchozím nastavení nasdílí aktuální umístění do aktuálního zásobníku umístění, ale k určení zásobníku alternativního umístění můžete použít parametr StackName. Pokud zásobník neexistuje, Push-Location ho vytvoří.

Další informace o zásobníkech umístění najdete v Poznámky.

Příklady

Příklad 1

Tento příklad nasdílí aktuální umístění do výchozího zásobníku umístění a pak změní umístění na C:\Windows.

PS C:\> Push-Location C:\Windows

Příklad 2

Tento příklad nasdílí aktuální umístění do zásobníku RegFunction a změní aktuální umístění na HKLM:\Software\Policies umístění.

PS C:\> Push-Location HKLM:\Software\Policies -StackName RegFunction

Rutiny Umístění můžete použít na libovolné jednotce PowerShellu (PSDrive).

Příklad 3

Tento příkaz odešle aktuální umístění do výchozího zásobníku. Umístění se nezmění.

PS C:\> Push-Location

Příklad 4 – Vytvoření a použití pojmenovaného zásobníku

Tyto příkazy ukazují, jak vytvořit a použít pojmenovaný zásobník umístění.

PS C:\> Push-Location ~ -StackName Stack2
PS C:\Users\User01> Pop-Location -StackName Stack2
PS C:\>

První příkaz nasdílí aktuální umístění do nového zásobníku s názvem Stack2 a pak změní aktuální umístění na domovský adresář reprezentovaný v příkazu symbolem tilda (~), který při použití na jednotkách zprostředkovatele FileSystem odpovídá $HOME.

Pokud stack2 v relaci ještě neexistuje, Push-Location ho vytvoří. Druhý příkaz použije rutinu Pop-Location k otevření původního umístění (C:\) ze zásobníku Stack2. Bez parametru StackName by se Pop-Location zobrazilo umístění z nepojmenovaného výchozího zásobníku.

Další informace o zásobníkech umístění najdete v Poznámky.

Parametry

-LiteralPath

Určuje cestu k novému umístění. Na rozdíl od parametru Path se hodnota parametru LiteralPath používá přesně tak, jak je zadán. Žádný znak není interpretován jako zástupný znak. Pokud cesta obsahuje únikové znaky, uzavřete ji do jednoduchých uvozovek. Jednoduché uvozovky říkají PowerShellu, aby žádné znaky neinterpretoval jako únikové sekvence.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:PSPath, PO

Sady parametrů

LiteralPath
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-PassThru

Předá objekt představující umístění kanálu. Ve výchozím nastavení tato rutina negeneruje žádný výstup.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Path

Změní umístění na umístění určené touto cestou po přidání (nasdílení) aktuálního umístění do horní části zásobníku. Zadejte cestu k libovolnému umístění, jehož zprostředkovatel tuto rutinu podporuje. Jsou povoleny zástupné symboly. Název parametru je volitelný.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:True
DontShow:False

Sady parametrů

Path
Position:1
Povinné:False
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-StackName

Určuje zásobník umístění, do kterého se přidá aktuální umístění. Zadejte název zásobníku umístění. Pokud zásobník neexistuje, Push-Location ho vytvoří.

Bez tohoto parametru Push-Location přidá umístění do aktuálního zásobníku umístění. Ve výchozím nastavení je aktuální zásobník umístění nepojmenovaný výchozí zásobník umístění, který PowerShell vytvoří. Pokud chcete vytvořit zásobník umístění jako aktuální zásobník umístění, použijte parametr StackName rutiny Set-Location. Další informace o zásobníkech umístění najdete v Poznámky.

Poznámka:

Push-Location nelze přidat umístění do nepojmenovaného výchozího zásobníku, pokud se nejedná o aktuální zásobník umístění.

Vlastnosti parametru

Typ:String
Default value:Default stack
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

String

K této rutině můžete převést řetězec, který obsahuje cestu (ale ne literálovou cestu).

Výstupy

None

Ve výchozím nastavení tato rutina nevrací žádný výstup.

PathInfo

Pokud použijete parametr PassThru, vrátí tato rutina objekt PathInfo představující aktuální cestu po operaci rutiny.

Poznámky

PowerShell obsahuje následující aliasy pro Push-Location:

  • Všechny platformy:
    • pushd

PowerShell podporuje více běžících prostorů na proces. Každý runspace má svůj vlastní aktuální adresář. To není stejné jako [System.Environment]::CurrentDirectory. Toto chování může být problém při volání rozhraní .NET API nebo spouštění nativních aplikací bez poskytování explicitních cest k adresářům.

I když rutiny umístění nastavily aktuální adresář pro celý proces, nemůžete na něm záviset, protože ho může kdykoli změnit jiný runspace. Rutiny umístění byste měli použít k provádění operací založených na cestě pomocí aktuálního pracovního adresáře specifického pro aktuální prostředí Runspace.

Zásobník je poslední první seznam, ve kterém je přístupná pouze naposledy přidaná položka. Položky přidáte do zásobníku v pořadí, v jakém je používáte, a pak je načtete pro použití v obráceném pořadí. PowerShell umožňuje ukládat umístění zprostředkovatelů do zásobníků umístění.

PowerShell vytvoří nepojmenovaný výchozí zásobník umístění a můžete vytvořit několik pojmenovaných zásobníků umístění. Pokud nezadáte název zásobníku, PowerShell použije aktuální zásobník umístění. Ve výchozím nastavení je nepojmenované výchozí umístění aktuální zásobník umístění, ale ke změně aktuálního zásobníku umístění můžete použít rutinu Set-Location.

Ke správě zásobníků umístění použijte rutiny umístění PowerShellu následujícím způsobem.

  • Pokud chcete přidat umístění do zásobníku umístění, použijte rutinu Push-Location.

  • Pokud chcete získat umístění ze zásobníku umístění, použijte rutinu Pop-Location.

  • Pokud chcete zobrazit umístění v aktuálním zásobníku umístění, použijte parametr Stack rutiny Get-Location.

  • Pokud chcete zobrazit umístění v pojmenovaném zásobníku umístění, použijte parametr StackName rutiny Get-Location.

  • Pokud chcete vytvořit nový zásobník umístění, použijte parametr StackName rutiny Push-Location. Pokud zadáte zásobník, který neexistuje, Push-Location zásobník vytvoří.

  • Pokud chcete vytvořit zásobník umístění jako aktuální zásobník umístění, použijte parametr StackName rutiny Set-Location.

Výchozí zásobník nenaznačeného umístění je plně přístupný jenom v případech, kdy se jedná o aktuální zásobník umístění. Pokud nastavíte pojmenovaný zásobník umístění jako aktuální zásobník umístění, nebudete už moct rutiny Push-Location nebo Pop-Location přidat nebo získat položky z výchozího zásobníku nebo pomocí rutiny Get-Location zobrazit umístění v nepojmenovaném zásobníku. Pokud chcete, aby byl zásobník bez názvu aktuální, použijte parametr StackName rutiny Set-Location s hodnotou $null nebo prázdným řetězcem ("").

Můžete také odkazovat na Push-Location jeho předdefinovaný alias pushd. Další informace viz about_Aliases.

Rutina Push-Location je navržená tak, aby fungovala s daty vystavenými jakýmkoli poskytovatelem. Chcete-li zobrazit seznam poskytovatelů dostupných ve vaší relaci, napište Get-PSProvider. Pro více informací viz about_Providers.