Push-Location

  • Referencia
Modul:
Microsoft.PowerShell.Management

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 ("leküldés") az aktuális helyet egy helyveremhez. Ha elérési utat ad meg, 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 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 veremébe, 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 a következőre C:\Windowsmó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ű $HOME.

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

A helyveremekkel kapcsolatos további információkért tekintse meg a Jegyzeteket.

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ékét pontosan a beírt módon használja a rendszer. A rendszer egyetlen karaktert sem értelmez helyettesítő karakterként. Ha az elérési út tartalmaz escape karaktereket, csatolja egy idézőjelek közé. Az idézőjelek azt mondják a PowerShellnek, hogy ne értelmezzen karaktereket feloldósorozatként.

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

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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ő.

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

-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 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 Set-Location parancsmag StackName paraméterét. A helyveremekkel kapcsolatos további információkért tekintse meg a Jegyzeteket.

Feljegyzé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
Required:False
Accept pipeline input:True
Accept wildcard characters:False

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

A PassThru paraméter használatakor ez a parancsmag egy PathInfo objektumot ad vissza, amely a parancsmag működése után az aktuális elérési utat jelöli.

Jegyzetek

A PowerShell a következő aliasokat Push-Locationtartalmazza:

  • Minden platform:
    • pushd

A PowerShell folyamatonként több futtatóteret támogat. Minden runspace saját aktuális könyvtárral rendelkezik. Ez nem ugyanaz, mint [System.Environment]::CurrentDirectorya . 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 veremét.

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 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 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-LocationPop-Location parancsmagokat az alapértelmezett verem elemeinek hozzáadására vagy lekérésére, vagy a Get-Location parancsmag használatával megjelenítheti 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 $null egy üres sztring ("") értékével.

Hivatkozhat a Push-Location beépített aliasára is. 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 következőt Get-PSProvider: További információ: about_Providers.