Megosztás a következőn keresztül:

Push-Location

Modul:
Microsoft.PowerShell.Management Module

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

Syntax

Path (Alapértelmezett) 

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

LiteralPath 

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

Description

A Push-Location parancsmag hozzáadja az aktuális helyet egy helyveremhez . Ha megad egy útvonalat, Push-Location leküldi az aktuális helyet egy helyverembe, majd az aktuális helyet az elérési út által megadott helyre módosítja. A Pop-Location parancsmaggal 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 verembe, 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 helyveremekről további információt a Jegyzetekcí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 helyverembe, majd a helyet C:\Windowsértékre módosítja.

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 Hely 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 helyvermet.

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 a fájlrendszer-szolgáltató meghajtóinak használata esetén egyenértékű a $HOME.

Ha a Stack2 még nem létezik a munkamenetben, Push-Location hozza létre. A második parancs a Pop-Location parancsmaggal irányítja le az eredeti helyet (C:\) a Stack2 veremből. A StackName paraméter nélkül a Pop-Location a névtelen alapértelmezett veremből irányítja a helyet.

A helyveremekről további információt a Jegyzetekcímű témakörben talál.

Paraméterek

-LiteralPath

Megadja az új hely elérési útját. A Path paramétertől eltérően a LiteralPath paraméter értéke pontosan a beíráskor lesz használva. A rendszer egyetlen karaktert sem értelmez helyettesítő karakterként. Ha az elérési útvonal escape karaktereket tartalmaz, tedd azt egyes idézőjelek közé. Az egyes idézőjelek azt mondják a PowerShellnek, hogy egyetlen karaktert se értelmezzen escape szekvenciaként.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:PSPath, LP

Paraméterkészletek

LiteralPath
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-PassThru

Átad egy helyet képviselő objektumot a folyamatnak. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Path

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

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:True
DontShow:False

Paraméterkészletek

Path
Position:1
Kötelező:False
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-StackName

Azt a helyvermet adja meg, amelyhez az aktuális hely hozzáadva van. Adjon meg egy helyveremnevet. Ha a verem nem létezik, Push-Location hozza létre.

E paraméter nélkül Push-Location 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 Set-Location paraméterét. A helyveremekről további információt a Jegyzetekcímű témakörben talál.

Megjegyzés:

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

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:Default stack
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

String

A parancsmag elérési útját (de nem literális elérési útját) tartalmazó sztringet csövezheti.

Kimenetek

None

Ez a parancsmag alapértelmezés szerint nem ad vissza kimenetet.

PathInfo

Ha a PassThru paramétert használja, ez a parancsmag egy PathInfo objektumot ad vissza, amely a parancsmag működése után az aktuális útvonalat jelöli.

Jegyzetek

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

  • Minden platform:
    • pushd

A PowerShell folyamatonként több futtatóteret támogat. Minden futtatási környezetnek megvan a saját jelenlegi könyvtára. Ez nem ugyanaz, mint [System.Environment]::CurrentDirectory. Ez a viselkedés akkor lehet probléma, ha .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 futtatótérre jellemző aktuális munkakönyvtár használatával.

A verem egy utolsó előtti 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 a szolgáltatói helyek helyvermekben való tárolását.

A PowerShell létrehoz egy névtelen alapértelmezett helyvermet, é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 helyverem helyeinek megjelenítéséhez használja a parancsmag Get-Location paraméterét.

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

  • Új helyverem létrehozásához használja a Push-Location parancsmag StackName paraméterét. Ha nem létező vermet ad meg, Push-Location hozza létre a vermet.

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

A névtelen alapértelmezett helyverem 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 továbbiakban nem használhatja a Push-Location vagy Pop-Location parancsmagokat az alapértelmezett verem elemeinek hozzáadásához vagy lekéréséhez, vagy a Get-Location parancsmag használatával megjelenítheti a névtelen veremben lévő helyeket. A névtelen verem aktuális veremként való létrehozásához használja a parancsmag Set-Location paraméterét $null értékkel vagy üres sztringgel ("").

A Push-Location is hivatkozhat a beépített aliasára, 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ájához írja be a Get-PSProvider. További információért lásd a about_Providerscímű részt.