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 ("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:\Windows
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ű $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
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.
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-Location
tartalmazza:
- 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]::CurrentDirectory
a . 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-Location
Pop-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.
Kapcsolódó hivatkozások
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: