Push-Location

Hozzáadja az aktuális helyet egy helyverem tetejére.

Syntax

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

Description

A Push-Location parancsmag hozzáadja az aktuális helyet egy helyveremhez ("leküldés"). Ha elérési utat ad meg, Push-Location az aktuális helyet leküldi egy helyverembe, majd az aktuális helyet az elérési út által megadott helyre módosítja. A parancsmaggal Pop-Location lekérheti a helyeket a helyveremből.

Alapértelmezés szerint a Push-Location parancsmag leküldi az aktuális helyet az aktuális hely vermére, de a StackName paraméter használatával megadhat egy másik helyvermet. Ha a verem nem létezik, Push-Location hozza létre.

A helyvermekről további információt a Megjegyzések című témakörben talál.

Példák

1\. példa

Ez a példa leküldi az aktuális helyet az alapértelmezett hely verembe, majd a helyet a következőre módosítja: C:\Windows.

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

2\. példa

Ez a példa leküldi az aktuális helyet a RegFunction verembe, és az aktuális helyet a HKLM:\Software\Policies helyre módosítja.

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

A Location parancsmagokat bármely PowerShell-meghajtón (PSDrive) használhatja.

3\. példa

Ez a parancs leküldi az aktuális helyet az alapértelmezett verembe. Nem módosítja a helyet.

PS C:\> Push-Location

4. példa – Névvel ellátott verem létrehozása és használata

Ezek a parancsok bemutatják, hogyan hozhat létre és használhat elnevezett hely vermet.

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

Az első parancs leküldi az aktuális helyet egy stack2 nevű új verembe, majd az aktuális helyet a kezdőkönyvtárra módosítja, amelyet a parancsban a tilde szimbólum (~) jelöl, amely fájlrendszer-szolgáltató meghajtókon való használata esetén egyenértékű $HOMEa paranccsal.

Ha a Stack2 még nem létezik a munkamenetben, Push-Location hozza létre. A második parancs a parancsmagot használja az Pop-Location eredeti hely (C:\) a Stack2 veremből való megjelenítéséhez. A StackName paraméter Pop-Location nélkül a nem nevesítetlen alapértelmezett veremből előugrik a hely.

A helyvermekről további információt a Megjegyzések című témakörben talál.

Paraméterek

-LiteralPath

Megadja az új hely elérési útját. Az Elérési út paramétertől eltérően a LiteralPath paraméter értéke pontosan a beírt módon lesz felhasználva. A rendszer egyetlen karaktert sem értelmez helyettesítő karakterként. Ha az elérési út tartalmaz feloldó karaktereket, akkor azt egy idézőjelek közé kell tenni. Az egy idézőjelek azt jelzik a PowerShellnek, hogy ne értelmezze a karaktereket feloldósorozatként.

Type:String
Aliases:PSPath, LP
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Átadja a helyet képviselő objektumot a folyamatnak. Alapértelmezés szerint ez a parancsmag nem ad kimenetet.

Type:SwitchParameter
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Módosítsa a helyet az elérési út által megadott helyre, miután hozzáadja (leküldi) az aktuális helyet a verem tetejére. Adjon meg egy elérési utat minden olyan helyhez, ahol a szolgáltató támogatja ezt a parancsmagot. Helyettesítő karakterek használata engedélyezett. A paraméter neve nem kötelező.

Type:String
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:True

-StackName

Meghatározza azt a hely vermet, amelyhez az aktuális helyet hozzáadták. Adja meg a hely veremnevét. Ha a verem nem létezik, Push-Location hozza létre.

E paraméter Push-Location nélkül adja hozzá a helyet az aktuális helyveremhez. Alapértelmezés szerint az aktuális hely verem a PowerShell által létrehozott névtelen alapértelmezett helyverem. A helyverem aktuális helyveremként való létrehozásához használja a parancsmag StackName paraméterét Set-Location . A helyvermekről további információt a Megjegyzések című témakörben talál.

Megjegyzés

Push-Location Csak akkor adhat hozzá helyet a névtelen alapértelmezett veremhez, ha az az aktuális hely verem.

Type:String
Position:Named
Default value:Default stack
Accept pipeline input:True
Accept wildcard characters:False

Bevitelek

String

Olyan sztringet csövezhet, amely elérési utat tartalmaz (de nem literális elérési utat) a parancshoz Push-Location.

Kimenetek

None or System.Management.Automation.PathInfo

A PassThru paraméter Push-Location használatakor létrehoz egy System.Management.Automation.PathInfo objektumot, amely a helyet jelöli. Ellenkező esetben ez a parancsmag nem hoz létre kimenetet.

Jegyzetek

A PowerShell a következő aliasokat tartalmazza:Push-Location

  • Minden platform:
    • pushd

A PowerShell folyamatonként több futtatóteret is támogat. Minden runspace saját aktuális könyvtárral rendelkezik. Ez nem ugyanaz, mint a [System.Environment]::CurrentDirectory. Ez a viselkedés akkor lehet probléma, ha a .NET API-kat hív meg, vagy natív alkalmazásokat futtat explicit címtárelérési útvonalak megadása nélkül.

Még ha a helyparancsmagok beállították is a folyamatszintű aktuális könyvtárat, nem függhet attól, mert egy másik futtatótér bármikor módosíthatja. A hely parancsmagjaival útvonalalapú műveleteket kell végrehajtania az aktuális runspace-hez tartozó aktuális munkakönyvtár használatával.

A verem egy utolsó be- és kiugró lista, amelyben csak a legutóbb hozzáadott elem érhető el. Elemeket ad hozzá egy veremhez a használt sorrendben, majd lekéri őket fordított sorrendben való használatra. A PowerShell lehetővé teszi, hogy a szolgáltatói helyeket helyvermekben tárolja.

A PowerShell létrehoz egy névtelen alapértelmezett hely vermet, és több elnevezett helyvermet is létrehozhat. Ha nem ad meg veremnevet, a PowerShell az aktuális hely vermet használja. Alapértelmezés szerint a névtelen alapértelmezett hely az aktuális hely verem, de a Set-Location parancsmaggal módosíthatja az aktuális hely vermet.

A helyvermek kezeléséhez használja a PowerShell Hely parancsmagjait az alábbiak szerint.

  • Ha helyet szeretne hozzáadni egy helyveremhez, használja a Push-Location parancsmagot.

  • Ha helyet szeretne lekérni egy helyveremből, használja a Pop-Location parancsmagot.

  • Az aktuális hely veremben lévő helyek megjelenítéséhez használja a parancsmag Stack paraméterét Get-Location .

  • A helyek nevesített helyveremben való megjelenítéséhez használja a parancsmag StackName paraméterét Get-Location .

  • Új helyverem létrehozásához használja a parancsmag StackName paraméterét Push-Location . Ha olyan vermet ad meg, amely nem létezik, Push-Location létrehozza a vermet.

  • A helyverem aktuális helyveremként való létrehozásához használja a parancsmag StackName paraméterét Set-Location .

A névtelen alapértelmezett hely verem csak akkor érhető el teljes mértékben, ha az aktuális hely verem. Ha egy elnevezett hely vermet hoz létre az aktuális hely veremként, a vagy parancsmagokkal többé Push-Location nem adhat hozzá vagy Pop-Location kérhet le elemeket az alapértelmezett veremből, vagy a Get-Location parancsmaggal megjelenítheti a helyeket a névtelen veremben. A névtelen verem aktuális veremként való beállításához használja a parancsmag StackName paraméterét Set-Location$null egy vagy egy üres sztring ("") értékével.

A beépített aliasára is hivatkozhat Push-Location , amely a következő: pushd. További információ: about_Aliases.

A Push-Location parancsmag úgy lett kialakítva, hogy bármely szolgáltató által közzétett adatokkal működjön együtt. A munkamenetben elérhető szolgáltatók listázásához írja be a következőt Get-PSProvider: . További információ: about_Providers.