Get-Location
Információt kap az aktuális munkahelyről vagy egy helyveremről.
Syntax
Location (Alapértelmezett)
Get-Location
[-PSProvider <String[]>]
[-PSDrive <String[]>]
[-UseTransaction]
[<CommonParameters>]
Stack
Get-Location
[-Stack]
[-StackName <String[]>]
[-UseTransaction]
[<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 Windows PowerShell-meghajtók közötti váltáskor a Windows PowerShell megőrzi a tartózkodási helyét az egyes meghajtókon. 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 Windows 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
PS C:\> Get-Location
Path
----
C:\WINDOWS
Ez a parancs megjeleníti a tartózkodási helyét az aktuális Windows PowerShell-meghajtón.
Ha például a C: meghajtó Windows 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
The first command uses the **Set-Location** cmdlet to set the current location to the Windows subdirectory of the C: drive.
PS C:\> Set-Location C:\Windows
The second command uses the **Set-Location** cmdlet to change the location to the HKLM:\Software\Microsoft registry key. When you change to a location in the HKLM: drive, Windows PowerShell retains your location in the C: drive.
PS C:\>
PS C:\WINDOWS> Set-Location HKLM:\Software\Microsoft
PS HKLM:\Software\Microsoft>
The third command uses the **Set-Location** cmdlet to change the location to the HKCU:\Control Panel\Input Method registry key.
PS C:\>
PS HKLM:\Software\Microsoft> Set-Location "HKCU:\Control Panel\Input Method"
PS HKCU:\Control Panel\Input Method>
The fourth command uses the **Get-Location** cmdlet to find the current location on the C: drive. It uses the *PSDrive* parameter to specify the drive.
PS C:\>
PS HKCU:\Control Panel\Input Method> Get-Location -PSDrive C
Path
----
C:\WINDOWS
The fifth command uses the **Set-Location** cmdlet to return to the C: drive. Even though the command does not specify a subdirectory, Windows PowerShell returns you to the saved location.
PS C:\>
PS HKCU:\Control Panel\Input Method> Set-Location C:
PS C:\WINDOWS>
The sixth command uses the **Get-Location** cmdlet to find the current location in the drives supported by the Windows PowerShell registry provider. **Get-Location** returns the location of the most recently accessed registry drive, HKCU.
PS C:\>
PS C:\WINDOWS> Get-Location -PSProvider registry
Path
----
HKCU:\Control Panel\Input Method
To see the current location in the HKLM: drive, you need to use the *PSDrive* parameter to specify the drive. The seventh command does just this:
PS C:\>
PS C:\WINDOWS> Get-Location -PSDrive HKLM
Path
----
HKLM:\Software\Microsoft
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ő Windows PowerShell-meghajtókon.
3. példa: Az aktuális helyverem helyeinek és alternatív helyveremeinek listázása
The first command sets the current location to the Windows directory on the C: drive.
PS C:\> Set-Location C:\Windows
The second command uses the **Push-Location** cmdlet to push the current location (C:\Windows) onto the current location stack and change to the System32 subdirectory. Because no stack is specified, the current location is pushed onto the current location stack. By default, the current location stack is the unnamed default location stack.
C:\WINDOWS> Push-Location System32
The third command uses the *StackName* parameter of the **Push-Location** cmdlet to push the current location (C:\Windows\System32) onto the Stack2 stack and to change the current location to the WindowsPowerShell subirectory. If the Stack2 stack does not exist, **Push-Location** creates it.
C:\Windows\System32> Push-Location WindowsPowerShell -StackName Stack2
The fourth command uses the *Stack* parameter of the **Get-Location** cmdlet to get the locations in the current location stack. By default, the current stack is the unnamed default location stack.
C:\WINDOWS\system32\WindowsPowerShell> Get-Location -Stack
Path
----
C:\WINDOWS
The fifth command uses the *StackName* parameter of the **Get-Location** cmdlet to get the locations in the Stack2 stack.
PS C:\>
C:\WINDOWS\system32\WindowsPowerShell>get-location -stackname Stack2
Path
----
C:\WINDOWS\system32
Ez a parancs bemutatja, hogyan használhatja a Stack és StackNameGet-Location paramétereit az aktuális helyverem és a másodlagos helyverem helyeinek listázásához. A helyveremekkel kapcsolatos további információkért tekintse meg a Jegyzeteket.
4. példa: A Windows PowerShell-parancssor testreszabása
PS C:\>
function prompt { 'PowerShell: ' + (get-location) + '> '}
PowerShell: C:\WINDOWS>
Ez a példa bemutatja, hogyan szabhatja testre a Windows PowerShell-parancssort. A parancssort meghatározó függvény tartalmaz egy Get-Location parancsot, amely akkor fut, amikor a parancssor megjelenik a konzolon.
Az alapértelmezett Windows PowerShell-parancssor formátumát egy parancssor nevű speciális függvény határozza meg. A parancssort egy parancssor nevű új fü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
A parancs a függvény kulcsszójával kezdődik, amelyet a függvény neve, a parancssor követ. A függvénytörzs a kapcsos zárójelek között ({}) jelenik meg.
Ez a parancs egy új parancssort határoz meg, amely a PowerShell sztringgel kezdődik: . Az aktuális hely hozzáfűzéséhez egy Hely lekérése parancsot használ, amely a parancssori függvény meghívásakor fut. A parancssor a következő sztringgel végződik: ">".
Paraméterek
-PSDrive
Megadja a megadott Windows PowerShell-meghajtó aktuális helyét, amelyet ez a parancsmag a műveletbe kap.
Ha például a Tanúsítvány: meghajtóban van, ezzel a paraméterlel megkeresheti a C: meghajtó aktuális helyét.
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
A Windows PowerShell-szolgáltató által támogatott meghajtó aktuális helyét adja meg, amelyet ez a parancsmag a műveletbe kap.
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 helyet a Windows PowerShellRegistry 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 helyverem helyeit.
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.
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 paramétert. A helyveremekkel kapcsolatos további információkért tekintse meg a Jegyzeteket.
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 |
-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
None
Ehhez a parancsmaghoz nem csövezhet be bemenetet.
Kimenetek
System.Management.Automation.PathInfo or System.Management.Automation.PathInfoStack
Ha a Stack vagy StackName paramétereket használja, ez a parancsmag egy StackInfo objektumot ad vissza. Ellenkező esetben egy PathInfo objektumot ad vissza.
Jegyzetek
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ó: about_Providers.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 Windows PowerShell lehetővé teszi a szolgáltatói helyek helyvermekben való tárolását. A Windows 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 Windows PowerShellLocation 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 Get-Location parancsmag Stack paraméterét. A helyek nevesített helyveremben való megjelenítéséhez használja a Get-Location parancsmag StackName 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, a továbbiakban nem használhatja a leküldéses hely vagy pop-location elemeket felvenni vagy lekérni az alapértelmezett veremből, vagy ezzel a parancsmaggal megjelenítheti a névtelen veremben lévő helyeket. Ha a névtelen vermet az aktuális veremként szeretné beállítani, használja a Set-Location parancsmag StackName paraméterét $null értékkel vagy üres sztringgel ("").