Agrega la ubicación actual al principio de una lista de ubicaciones ("pila").
Sintaxis
Push-Location [[-LiteralPath] <string>] [-PassThru] [-StackName <string>] [-UseTransaction] [<CommonParameters>] Push-Location [[-Path] <string>] [-PassThru] [-StackName <string>] [-UseTransaction] [<CommonParameters>]
Descripción
El cmdlet Push-Location agrega ("inserta") la ubicación actual al principio de una lista de ubicaciones, denominada "pila". Se puede insertar la ubicación actual en una pila predeterminada o en una pila creada por el usuario. Si se especifica una ruta, Push-Location inserta la ubicación actual en la pila y después cambia la ubicación actual por la ubicación especificada en la ruta. No se puede insertar una ubicación en la pila a menos que sea la ubicación actual.
Parámetros
-LiteralPath <string>
Especifica la ruta de acceso a la nueva ubicación. A diferencia del parámetro Path, el valor del parámetro LiteralPath se usa literalmente como se escribe. Ningún carácter se interpretará como un carácter comodín. Si la ruta incluye caracteres de escape, escríbala entre comillas simples. Las comillas simples indican a Windows PowerShell que no debe interpretar los caracteres como secuencias de escape.
|
¿Requerido? |
false |
|
¿Posición? |
1 |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByPropertyName) |
|
¿Aceptar caracteres comodín? |
false |
-PassThru
Pasa a la canalización un objeto que representa la ubicación. De forma predeterminada, este cmdlet no genera resultados.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Path <string>
Cambia la ubicación a la especificada por esta ruta después de agregar (insertar) la ubicación actual a la parte superior de la pila. Escriba una ruta a cualquier ubicación cuyo proveedor admita este cmdlet. Se permite el uso de caracteres comodín. El nombre del parámetro ("Path") es opcional.
|
¿Requerido? |
false |
|
¿Posición? |
1 |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByValue, ByPropertyName) |
|
¿Aceptar caracteres comodín? |
false |
-StackName <string>
Especifica el nombre de una pila. Se inserta la ubicación actual en la pila y esta pila se convierte en la pila actual. Si la pila no existe, se creará.
|
¿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 |
System.String Puede canalizar a Push-Location una cadena que contiene una ruta de acceso (que no sea una ruta de acceso literal). |
|
Salidas |
Ninguno o System.Management.Automation.PathInfo Cuando se utiliza el parámetro PassThru, Push-Location genera un objeto System.Management.Automation.PathInfo que representa la ubicación. En caso contrario, este cmdlet no genera resultados. |
Notas
También puede hacer referencia a Push-Location mediante su alias integrado, "pushd". Para obtener más información, vea about_Aliases.
Una "pila" es una estructura de datos LIFO (el último en entrar es el último en salir). Es como una lista vertical en la que solo el elemento superior es accesible. Solo se pueden agregar ("insertar") elementos al principio de la pila y solo se pueden recuperar ("obtener") elementos del principio de la pila. Para obtener elementos situados por debajo del principio de la pila, se deben recuperar todos los elementos anteriores.
El cmdlet Push-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>push-location C:\Windows Descripción ----------- Este comando inserta la ubicación actual en la pila predeterminada y cambia la ubicación a C:\Windows.
Ejemplo 2
C:\PS>push-location HKLM:\Software\Policies -stackname RegFunction Descripción ----------- Este comando inserta la ubicación actual en la pila RegFunction y cambia la ubicación actual por la ubicación HKLM:\Software\Policies. Este comando muestra que se puede usar Push-Location con el proveedor Registry de Windows PowerShell.
Ejemplo 3
C:\PS>push-location Descripción ----------- Este comando inserta la ubicación actual en la pila predeterminada.
Ejemplo 4
C:\PS>push-location ~ -stackname Stack2 Descripción ----------- Este comando inserta la ubicación actual en una nueva pila denominada Stack2 y cambia la ubicación actual por el directorio principal (%USERPROFILE%), que está representado por el símbolo de tilde (~) o $home. La pila Stack2 se convierte en la pila actual.
Vea también