Compartir a través de

Set-Location

  • Referencia
Módulo:
Microsoft.PowerShell.Management

Establece la ubicación de trabajo actual en una ubicación especificada.

Sintaxis

Set-Location
   [[-Path] <String>]
   [-PassThru]
   [-UseTransaction]
   [<CommonParameters>]
Set-Location
   -LiteralPath <String>
   [-PassThru]
   [-UseTransaction]
   [<CommonParameters>]
Set-Location
   [-PassThru]
   [-StackName <String>]
   [-UseTransaction]
   [<CommonParameters>]

Description

El cmdlet Set-Location establece la ubicación de trabajo en una ubicación especificada. Esa ubicación podría ser un directorio, un subdirectorio, una ubicación del Registro o cualquier ruta de acceso del proveedor.

También puede usar el parámetro StackName para convertir una pila de ubicación con nombre en la pila de ubicación actual. Para obtener más información sobre las pilas de ubicación, vea notas.

Ejemplos

Ejemplo 1: Establecer la ubicación actual

PS C:\> Set-Location -Path "HKLM:"

PS HKLM:\>

Este comando establece la ubicación actual en la raíz de la unidad HKLM: .

Ejemplo 2: Establecer la ubicación actual y mostrar esa ubicación

PS C:\> Set-Location -Path "Env:" -PassThru

Path
----
Env:\

PS Env:\>

Este comando establece la ubicación actual en la raíz de la unidad Env: . Usa el parámetro PassThru para dirigir PowerShell para devolver un objeto PathInfo que representa la ubicación env: .

Ejemplo 3: Establecer la ubicación en la unidad C:

PS C:\> Set-Location C:

Este comando establece la unidad C: de ubicación actual en el proveedor FileSystem.

Ejemplo 4: Establecer la ubicación actual en una pila con nombre

PS C:\> Set-Location -StackName "WSManPaths"

Este comando hace que la pila de ubicación de WSManPaths sea la pila de ubicación actual.

Los cmdlets de *-Location usan la pila de ubicación actual a menos que se especifique una pila de ubicación diferente en el comando . Para obtener información sobre las pilas de ubicación, vea las notas.

Parámetros

-LiteralPath

Especifica una ruta de acceso de la ubicación. El valor del parámetro LiteralPath se usa exactamente como se escribe. No se interpreta ningún carácter comodín. Si la ruta de acceso incluye caracteres de escape, escríbala entre comillas simples. Las comillas simples indican a PowerShell que no interprete ningún carácter como secuencias de escape.

Las comillas simples indican a Windows PowerShell que no interprete ningún carácter como secuencias de escape.

Tipo:String
Alias:PSPath
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-PassThru

Devuelve un objeto PathInfo que representa la ubicación. De forma predeterminada, este cmdlet no genera ninguna salida.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Path

Especifique la ruta de acceso de una nueva ubicación de trabajo. Si no se proporciona ninguna ruta de acceso, Set-Location el valor predeterminado es el directorio principal del usuario actual. Cuando se usan caracteres comodín, el cmdlet elige la primera ruta de acceso que coincide con el patrón de caracteres comodín.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:True

-StackName

Especifica el nombre de la pila de ubicación que este cmdlet convierte en la pila de ubicación actual. Escriba un nombre de pila de ubicación. Para indicar la pila de ubicación predeterminada sin nombre, escriba $null o una cadena vacía ("").

Los cmdlets *-Location actúan en la pila actual a menos que use el parámetro StackName para especificar una pila diferente.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-UseTransaction

Incluye el comando en la transacción activa. Este parámetro solo es válido cuando una transacción está en curso. Para obtener más información, consulte about_Transactions.

Tipo:SwitchParameter
Alias:usetx
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

String

Puede canalizar una cadena que contenga una ruta de acceso, pero no una ruta de acceso literal, a este cmdlet.

Salidas

None, System.Management.Automation.PathInfo, System.Management.Automation.PathInfoStack

Este cmdlet no genera ninguna salida a menos que especifique el parámetro PassThru. Con PassThru con Path o LiteralPath genera un objeto pathInfo de que representa la nueva ubicación. Con PassThru con StackName genera un objeto PathInfoStack que representa el nuevo contexto de pila.

Notas

  • El cmdlet Set-Location está diseñado para trabajar con los datos expuestos por cualquier proveedor. Para enumerar los proveedores disponibles en la sesión, escriba Get-PSProvider. Para obtener más información, vea about_Providers.

    Una pila es una lista en la que solo se puede acceder al elemento agregado más recientemente. Agregue elementos a una pila en el orden en que los use y, a continuación, los recupere para usarlos en el orden inverso. PowerShell le permite almacenar ubicaciones de proveedor en pilas de ubicaciones. PowerShell crea una pila de ubicación predeterminada sin nombre. Puede crear varias pilas de ubicación con nombre. Si no especifica un nombre de pila, PowerShell usa la pila de ubicación actual. De forma predeterminada, la ubicación predeterminada sin nombre es la pila de ubicaciones actual, pero puede usar el cmdlet Set-Location para cambiar la pila de ubicación actual.

  • Para administrar las pilas de ubicación, use los cmdlets de *-Location, como se indica a continuación:

    • Para agregar una ubicación a una pila de ubicaciones, use el cmdlet Push-Location.

    • Para obtener una ubicación desde una pila de ubicaciones, use el cmdlet Pop-Location.

    • Para mostrar las ubicaciones en la pila de ubicaciones actual, use el parámetro stack de del cmdlet . Para mostrar las ubicaciones en una pila de ubicaciones con nombre, use el parámetro StackName de Get-Location.

    • Para crear una nueva pila de ubicación, use el parámetro StackName de Push-Location. Si especifica una pila que no existe, Push-Location crea la pila.

    • Para que una pila de ubicación sea la pila de ubicación actual, use el parámetro StackName de Set-Location.

      La pila de ubicación predeterminada sin nombre solo es totalmente accesible cuando es la pila de ubicación actual. Si crea una pila de ubicación con nombre en la pila de ubicaciones actual, ya no puede usar Push-Location ni Pop-Location cmdlets agregar ni obtener elementos de la pila predeterminada ni usar Get-Location para mostrar las ubicaciones en la pila sin nombre. Para convertir la pila sin nombre en la pila actual, use el parámetro StackName de Set-Location con un valor de $null o una cadena vacía ("").