Get-Location

  • Referencia
Modul:
Microsoft.PowerShell.Management

Információt kap az aktuális munkahelyről vagy egy helyveremről.

Syntax

Get-Location
   [-PSProvider <String[]>]
   [-PSDrive <String[]>]
   [<CommonParameters>]
Get-Location
   [-Stack]
   [-StackName <String[]>]
   [<CommonParameters>]

Description

A Get-Location parancsmag egy objektumot kap, amely az aktuális könyvtárat jelöli, hasonlóan a nyomtatási munkakönyvtár (pwd) parancshoz.

A PowerShell-meghajtók közötti váltáskor a PowerShell minden meghajtón megőrzi a tartózkodási helyét. Ezzel a parancsmaggal megtalálhatja a tartózkodási helyét az egyes meghajtókon.

Ezzel a parancsmaggal lekérheti az aktuális könyvtárat futásidőben, és használhatja függvényekben és szkriptekben, például egy olyan függvényben, amely megjeleníti az aktuális könyvtárat a PowerShell-parancssorban.

Ezzel a parancsmaggal is megjelenítheti a helyeket egy helyveremben. További információkért tekintse meg a Stack és a StackName paraméterek megjegyzéseit és leírását.

Példák

1. példa: Az aktuális meghajtó helyének megjelenítése

Ez a parancs megjeleníti a tartózkodási helyét az aktuális PowerShell-meghajtón.

PS C:\Windows> Get-Location

Path
----
C:\Windows

Ha például a Windows meghajtó könyvtárában C: van, az megjeleníti az adott könyvtár elérési útját.

2. példa: A különböző meghajtók aktuális helyének megjelenítése

Ez a példa bemutatja, hogy az aktuális hely különböző PowerShell-meghajtókon való megjelenítésére használható Get-Location . Set-Location a hely különböző PSDrive-okon való különböző elérési utakra való módosítására szolgál.

PS C:\> Set-Location C:\Windows
PS C:\Windows> Set-Location HKLM:\Software\Microsoft
PS HKLM:\Software\Microsoft> Set-Location "HKCU:\Control Panel\Input Method"
PS HKCU:\Control Panel\Input Method> Get-Location -PSDrive C

Path
----
C:\Windows

PS HKCU:\Control Panel\Input Method> Get-Location -PSDrive HKLM

Path
----
HKLM:\Software\Microsoft

PS HKCU:\Control Panel\Input Method> Set-Location C:
PS C:\Windows> Get-Location -PSProvider Registry

Path
----
HKCU:\Control Panel\Input Method

3. példa: Helyek lekérése veremekkel

Ez a példa bemutatja, hogyan használhatja a Stack és StackName paramétereket Get-Location az aktuális helyverem és a másodlagos helyverem helyeinek listázásához.

A Push-Location parancsmag három különböző helyre vált. A harmadik leküldés egy másik veremnevet használ. A Stack paraméter Get-Location megjeleníti az alapértelmezett verem tartalmát. A StackName paraméter Get-Location megjeleníti a névvel ellátott Stack2verem tartalmát.

PS C:\> Push-Location C:\Windows
PS C:\Windows>Push-Location System32
PS C:\Windows\System32>Push-Location WindowsPowerShell -StackName Stack2
C:\Windows\System32\WindowsPowerShell>Get-Location -Stack

Path
----
C:\Windows
C:\

C:\Windows\System32\WindowsPowerShell>Get-Location -StackName Stack2

Path
----
C:\Windows\System32

4. példa: A PowerShell-parancssor testreszabása

Ez a példa bemutatja, hogyan szabhatja testre a PowerShell-parancssort.

PS C:\>
function prompt { 'PowerShell: ' + (Get-Location) + '> '}
PowerShell: C:\>

A parancssort meghatározó függvény tartalmaz egy Get-Location parancsot, amely akkor fut, amikor a parancssor megjelenik a konzolon.

Az alapértelmezett PowerShell-parancssor formátumát egy speciális, nevesített promptfüggvény határozza meg. A parancssort egy új, névvel ellátott promptfüggvény létrehozásával módosíthatja a konzolon.

Az aktuális parancssori függvény megtekintéséhez írja be a következő parancsot: Get-Content Function:\prompt

Paraméterek

-PSDrive

Lekéri az aktuális helyet a megadott PowerShell-meghajtón.

Ha például a meghajtón tartózkodik, ezzel a Cert: paraméterlel megkeresheti a C: meghajtó aktuális helyét.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PSProvider

Lekéri a megadott PowerShell-szolgáltató által támogatott meghajtó aktuális helyét. Ha a megadott szolgáltató több meghajtót is támogat, ez a parancsmag a legutóbb elért meghajtó helyét adja vissza.

Ha például a meghajtón van, ezzel a C: paraméterlel megkeresheti az aktuális helyét a PowerShell-beállításjegyzék-szolgáltató meghajtóiban.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Stack

Azt jelzi, hogy ez a parancsmag megjeleníti az aktuális hely veremhez hozzáadott helyeket. A parancsmaggal helyeket adhat hozzá a Push-Location halmokhoz.

Ha egy másik helyen szeretné megjeleníteni a helyeket, használja a StackName paramétert. A helyveremekkel kapcsolatos további információkért tekintse meg a Jegyzeteket.

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

-StackName

Sztringtömbként megadja a névvel ellátott helyvermeket. Adjon meg egy vagy több helyveremnevet.

Az aktuális helyverem helyeinek megjelenítéséhez használja a Stack paramétert. A helyverem aktuális helyveremként való létrehozásához használja a Set-Location parancsmagot.

Ez a parancsmag csak akkor tudja megjeleníteni a névtelen alapértelmezett veremben lévő helyeket, ha az aktuális verem.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Bevitelek

None

Ehhez a parancsmaghoz nem lehet objektumokat csövezni.

Kimenetek

PathInfo

Ez a parancsmag alapértelmezés szerint egy PathInfo objektumot ad vissza.

PathInfoStack

A Stack vagy StackName paraméterek használatakor ez a parancsmag egy PathInfoStack objektumot ad vissza.

Jegyzetek

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

  • Minden platform:

    • gl
    • pwd

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. A Get-Location parancsmag az aktuális PowerShell-futtatótér aktuális könyvtárát adja vissza.

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

A PSProvider, a PSDrive, a Stack és a StackName paraméterek közötti interakció módja a szolgáltatótól függ. Egyes kombinációk hibákat eredményeznek, például egy meghajtó és egy olyan szolgáltató megadását, amely nem teszi elérhetővé a meghajtót. Ha nincsenek megadva paraméterek, ez a parancsmag az aktuális munkahelyet tartalmazó szolgáltató PathInfo objektumát adja vissza.

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-parancsmagokat *-Location 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 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.