Obtiene información sobre la ubicación de trabajo actual.
Sintaxis
Get-Location [-PSDrive <string[]>] [-PSProvider <string[]>] [-UseTransaction] [<CommonParameters>] Get-Location [-Stack] [-StackName <string[]>] [-UseTransaction] [<CommonParameters>]
Descripción
El cmdlet Get-Location obtiene un objeto que representa el directorio actual, al igual que el comando pwd (imprimir directorio de trabajo).
Al moverse entre unidades de Windows PowerShell, Windows PowerShell conserva la ubicación en cada unidad. Puede utilizar Get-Location para buscar la ubicación en cada unidad.
También puede utilizar Get-Location para obtener el directorio actual en tiempo de ejecución y utilizarlo en funciones y scripts, como en una función que muestra el directorio actual en el símbolo del sistema de Windows PowerShell.
Si utiliza el cmdlet Push-Location para agregar ubicaciones a una pila de rutas de acceso, puede utilizar el parámetro Stack de Get-Location para mostrar la pila actual.
Parámetros
-PSDrive <string[]>
Obtiene la ubicación actual en la unidad de Windows PowerShell especificada.
Por ejemplo, si se está en la unidad Certificate:, se puede utilizar este parámetro para buscar la ubicación actual en la unidad C:.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
true (ByPropertyName) |
¿Aceptar caracteres comodín? |
false |
-PSProvider <string[]>
Obtiene la ubicación actual en la unidad admitida por el proveedor de Windows PowerShell especificado.
Si el proveedor especificado admite más de una unidad, Get-Location devuelve la ubicación en la última unidad a la que se ha obtenido acceso.
Por ejemplo, si se está en la unidad C:, se puede utilizar este parámetro para buscar la ubicación actual en las unidades del proveedor del Registro de Windows PowerShell.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
true (ByPropertyName) |
¿Aceptar caracteres comodín? |
false |
-Stack
Muestra las ubicaciones en la pila de rutas de acceso predeterminada.
Para agregar rutas de acceso a la pila predeterminada, utilice el cmdlet Push-Location.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-StackName <string[]>
Muestra las ubicaciones en las pilas de rutas de acceso especificadas.
Para crear pilas de rutas de acceso, utilice el cmdlet Push-Location.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
true (ByPropertyName) |
¿Aceptar caracteres comodín? |
false |
-UseTransaction
Incluye el comando en la transacción activa. Este parámetro sólo es válido cuando hay una transacción en curso. Para obtener más información, vea about_Transactions.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
<CommonParameters>
Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.
Entradas y salidas
El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.
Entradas |
Ninguno No se pueden canalizar entradas a este cmdlet. |
Salidas |
PathInfo objects or StackInfo objects Si utiliza los parámetros Stack o StackName, Get-Location devuelve un objeto StackInfo. De lo contrario, devuelve un objeto PathInfo. |
Notas
Las ubicaciones se pueden almacenar en una pila. El cmdlet Push-Location agrega una ubicación al principio de la pila. El cmdlet Pop-Location obtiene la ubicación en el principio de la pila.
La forma de interactuar de los parámetros PSProvider, PSDrive, Stack y StackName depende del proveedor. Algunas combinaciones provocarán errores, como especificar una unidad y un proveedor que no exponen dicha unidad. Si no se especifica ningún parámetro, Get-Location devuelve el objeto PathInfo para el proveedor que contiene la ubicación de trabajo actual.
El cmdlet Get-Location está diseñado para funcionar con los datos expuestos por cualquier proveedor. Para mostrar los proveedores que están disponibles en la sesión, escriba "Get-PSProvider". Para obtener más información, vea about_Providers.
Ejemplo 1
C:\PS>get-location Path ---- C:\WINDOWS Descripción ----------- Este comando muestra la ubicación en la unidad de Windows PowerShell actual. Por ejemplo, si se está en el directorio Windows de la unidad C:, se muestra la ruta de acceso a ese directorio.
Ejemplo 2
C:\PS>set-location Descripción ----------- Estos comandos demuestran el uso de Get-Location para mostrar la ubicación actual en diferentes unidades de Windows PowerShell. El primer comando utiliza el cmdlet Set-Location para establecer la ubicación actual en el subdirectorio Windows de la unidad C:. C:\PS> set-location C:\Windows El segundo comando usa el cmdlet Set-Location para cambiar la ubicación a la clave del Registro HKLM:\Software\Microsoft. Al cambiarse a una ubicación en la unidad HKLM:, Windows PowerShell conserva la ubicación en la unidad C:. PS C:\WINDOWS> set-location HKLM:\Software\Microsoft PS HKLM:\Software\Microsoft> El tercer comando usa el cmdlet Set-Location para cambiar la ubicación a la clave del Registro "HKCU:\Control Panel\Input Method". PS HKLM:\Software\Microsoft> set-location 'HKCU:\Control Panel\Input Method' PS HKCU:\Control Panel\Input Method> El cuarto comando usa el cmdlet Get-Location para buscar la ubicación actual en la unidad C:. Usa el parámetro PSDrive para especificar la unidad. PS HKCU:\Control Panel\Input Method> get-location -psdrive c Path ---- C:\WINDOWS El quinto comando utiliza el cmdlet Set-Location para volver a la unidad C:. Aunque el comando no especifica un subdirectorio, Windows PowerShell le devuelve a la ubicación guardada. PS HKCU:\Control Panel\Input Method> set-location C: PS C:\WINDOWS> El sexto comando usa el cmdlet Get-Location para buscar la ubicación actual en las unidades admitidas por el proveedor del Registro de Windows PowerShell. Get-Location devuelve la ubicación de la última unidad del Registro a la que se ha obtenido acceso, HKCU:. PS C:\WINDOWS> get-location -psprovider registry Path ---- HKCU:\Control Panel\Input Method Para ver la ubicación actual en la unidad HKLM:, es necesario utilizar el parámetro PSDrive para especificar la unidad. El séptimo comando realiza simplemente esta acción: PS C:\WINDOWS> get-location -psdrive HKLM Path ---- HKLM:\Software\Microsoft
Ejemplo 3
C:\PS>set-location Descripción ----------- Estos comandos muestran la forma de utilizar los parámetros Stack y StackName de Get-Location para mostrar las rutas de acceso en las pilas de rutas de acceso predeterminada y alternativa. El primer comando establece la ubicación actual en el directorio Windows de la unidad C:. C:\PS> set-location C:\Windows El segundo comando usa el cmdlet Push-Location para insertar la ubicación actual (C:\Windows) en la pila de rutas de acceso y cambiar al subdirectorio System32. Dado que no se especifica ninguna pila, la ubicación actual se inserta en la pila predeterminada. C:\WINDOWS>push-location System32 El tercer comando inserta la ubicación actual (C:\Windows\System32) en la pila Stack2 y cambia la ubicación al subdirectorio WindowsPowerShell. C:\Windows\System32>push-location WindowsPowerShell -stack Stack2 El cuarto comando utiliza el cmdlet Get-Location para obtener las rutas de acceso en la pila de rutas de acceso predeterminada. C:\WINDOWS\system32\WindowsPowerShell>get-location -stack Path ---- C:\WINDOWS El último comando utiliza el parámetro StackName de Get-Location para obtener las rutas de acceso en la pila Stack2. C:\WINDOWS\system32\WindowsPowerShell>get-location -stackname Stack2 Path ---- C:\WINDOWS\system32
Ejemplo 4
C:\PS>function prompt { 'PowerShell: ' + (get-location) + '> '} PowerShell: C:\WINDOWS> Descripción ----------- En este ejemplo se muestra la forma de personalizar el símbolo del sistema de Windows PowerShell. La función que define el símbolo del sistema incluye un comando Get-Location que se ejecuta cada vez que el símbolo del sistema aparece en la consola. El formato del símbolo del sistema de Windows PowerShell predeterminado lo define una función especial denominada "prompt". Puede cambiar el símbolo del sistema en la consola creando una nueva función denominada "prompt". Para ver la función "prompt" actual, escriba el comando siguiente: get-content function:prompt El comando comienza con la palabra clave "function" seguida del nombre de la función, "prompt". El cuerpo de la función aparece entre llaves ({}). Este comando define un nuevo símbolo del sistema que comienza con la cadena "PowerShell:". Para anexar la ubicación actual, utiliza un comando Get-Location que se ejecuta cuando se llama a la función "prompt". El símbolo del sistema finaliza con la cadena">".
Vea también