Get-Location

Modul:

Microsoft.PowerShell.Management Module

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

Syntax

Location (Alapértelmezett)

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

Stack

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

Description

A Get-Location parancsmag olyan 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 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ó C: könyvtárában 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 a Get-Location használatával jelenítheti meg az aktuális tartózkodási helyét különböző PowerShell-meghajtókon. Set-Location a különböző PSDrive-okon több különböző útvonalra módosíthatja a helyet.

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álható a Stack és StackName paramétere 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 Get-Location paramétere megjeleníti az alapértelmezett verem tartalmát. A Get-Location paramétere megjeleníti a Stack2nevű verem 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 promptnevű speciális függvény határozza meg. A promptnevű új függvény létrehozásával módosíthatja a parancssort 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 Cert: meghajtón tartózkodik, ezzel a paraméterlel megkeresheti az aktuális helyet a C: meghajtón.

Paramétertulajdonságok

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

Paraméterkészletek

Location

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

-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 C: meghajtón tartózkodik, ezzel a paraméterlel megkeresheti az aktuális helyét a PowerShell-Beállításjegyzék--szolgáltató meghajtóiban.

Paramétertulajdonságok

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

Paraméterkészletek

Location

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

-Stack

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

Ha egy másik helyen szeretné megjeleníteni a helyeket, használja a StackName paramétert. A helyvermekről további információt a Jegyzetcímű témakörben talál.

Paramétertulajdonságok

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

Paraméterkészletek

Stack

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

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

Paramétertulajdonságok

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

Paraméterkészletek

Stack

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

None

Ehhez a parancsmaghoz nem lehet objektumokat csövezni.

Kimenetek

PathInfo

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

PathInfoStack

Ha a Stack vagy StackName paramétert használja, ez a parancsmag egy PathInfoStack objektumot ad vissza.

Jegyzetek

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

• Minden platform:

  • gl
  • pwd

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. 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ájához írja be a Get-PSProvider. További információért lásd a about_Providerscímű részt.

A PSProvider, PSDrive, Stackés StackName paraméterek közötti interakciója 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 visszaadja a PathInfo objektumot az aktuális munkahelyet tartalmazó szolgáltató számára.

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 helyveremek kezeléséhez használja a PowerShell-*-Location parancsmagokat 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 parancsmag Push-Location 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 parancsmag Set-Location 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 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 parancsmag Set-Location paraméterét $null értékkel vagy üres sztringgel ("").

Kapcsolódó hivatkozások

• Pop-Location
• Push-Location
• Hely beállítása