Establece la ubicación de trabajo actual en una ubicación especificada.
Sintaxis
Set-Location [-LiteralPath] <string> [-PassThru] [-UseTransaction] [<CommonParameters>] Set-Location [[-Path] <string>] [-PassThru] [-UseTransaction] [<CommonParameters>] Set-Location [-StackName <string>] [-PassThru] [-UseTransaction] [<CommonParameters>]
Descripción
El cmdlet Set-Location establece la ubicación de trabajo en la ubicación especificada. Esa ubicación puede ser un directorio, un subdirectorio, una ubicación del Registro u otra pila de ubicaciones.
Parámetros
-LiteralPath <string>
Especifica la ruta de acceso a la ubicación. El valor del parámetro LiteralPath se usa exactamente 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? |
true |
|
¿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>
Este parámetro se usa para especificar la ruta a la nueva ubicación de trabajo.
|
¿Requerido? |
false |
|
¿Posición? |
1 |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByValue, ByPropertyName) |
|
¿Aceptar caracteres comodín? |
false |
-StackName <string>
El nombre de la pila en la que va a establecer la ubicación.
|
¿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 solo 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 Set-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, Set-Location genera un objeto System.Management.Automation.PathInfo que representa la ubicación. En caso contrario, este cmdlet no genera resultados. |
Notas
El cmdlet Set-Location está diseñado de modo que funcione 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>set-location HKLM: Descripción ----------- De este modo, se establece la ubicación actual en la especificada; en este caso, el proveedor HKLM.
Ejemplo 2
C:\PS>set-location env: -passthru Path ---- Env:\ Descripción ----------- De este modo, se establece la ubicación actual en la especificada; en este caso, el proveedor de variables de entorno.
Ejemplo 3
C:\PS>set-location C: Descripción ----------- De este modo, se establece la ubicación actual en la especificada; en este caso, la unidad C: del proveedor del sistema de archivos.
Vea también