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

LiteralPath 

Push-Location
    [-LiteralPath <String>]
    [-PassThru]
    [-StackName <String>]
    [-UseTransaction]
    [<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 helyveremekkel kapcsolatos további információkért tekintse meg a Jegyzeteket.

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 (ugyanaz, mint $env:USERPROFILE vagy $HOME).

Ha a Stack2 még nem létezik a munkamenetben, Push-Location hozza létre. A második parancs a Pop-Location parancsmagot használja az eredeti hely (PS C:\>) a Stack2 veremből való kiugrásához. A StackName paraméter nélkül Pop-Location a névtelen alapértelmezett veremből ugratná ki 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 idézőjelek azt jelzik, hogy a Windows PowerShell nem értelmezi a karaktereket menekülési sorozatként.

Paramétertulajdonságok

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

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 Set-Location parancsmag StackName 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

-UseTransaction

Tartalmazza a parancsot az aktív tranzakcióban. Ez a paraméter csak akkor érvényes, ha egy tranzakció folyamatban van. További információ: about_Transactions.

Paramétertulajdonságok

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

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

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 Push-Locationelérési útját tartalmazó sztringet (de nem literális elérési utat) is beszúrhat.

Kimenetek

None or System.Management.Automation.PathInfo

A PassThru paraméter használatakor Push-Location 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 "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 Windows 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, többé nem használhatja Push-Location vagy Pop-Location parancsmagok nem adhatnak hozzá vagy kérhetnek le elemeket az alapértelmezett veremből, vagy Get-Location paranccsal jelenítheti meg a helyeket a névtelen veremben. A névtelen verem aktuális veremként való létrehozásához használja a Set-Location parancsmag StackName paraméterét egy $null vagy egy üres sztring ("").

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.