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




Tabla de contenido