Join-Path

Combina una ruta y una ruta secundaria en una sola ruta. El proveedor especifica los delimitadores de ruta.

Sintaxis

Join-Path [-Path] <string[]> [-ChildPath] <string> [-Credential <PSCredential>] [-Resolve] [-UseTransaction] [<CommonParameters>]

Descripción

El cmdlet Join-Path combina una ruta y una ruta secundaria en una sola ruta. El proveedor especifica los delimitadores de ruta.

Parámetros

-ChildPath <string>

Especifica los elementos que se van a anexar al valor de Path. Se permite el uso de caracteres comodín. El parámetro ChildPath es obligatorio, aunque el nombre del parámetro ("ChildPath") es opcional.

¿Requerido?	true
¿Posición?	2
Valor predeterminado
¿Aceptar canalización?	true (ByPropertyName)
¿Aceptar caracteres comodín?	false

-Credential <PSCredential>

Especifica una cuenta de usuario con permiso para realizar esta acción. El valor predeterminado es el usuario actual.

Escriba un nombre de usuario, como "Usuario01" o "Dominio01\Usuario01". O bien, escriba un objeto PSCredential, como uno generado por el cmdlet Get-Credential. Si escribe un nombre de usuario se le pedirá una contraseña.

Este parámetro no es compatible con los proveedores que se instalan con Windows PowerShell.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	true (ByPropertyName)
¿Aceptar caracteres comodín?	false

-Path <string[]>

Especifica la ruta o rutas principales a las que se anexará la ruta secundaria. Se permite el uso de caracteres comodín.

El valor de Path determina qué proveedor une las rutas y agrega los delimitadores de ruta. El parámetro Path es obligatorio, aunque el nombre del parámetro ("Path") es opcional.

¿Requerido?	true
¿Posición?	1
Valor predeterminado
¿Aceptar canalización?	true (ByValue, ByPropertyName)
¿Aceptar caracteres comodín?	false

-Resolve

Muestra los elementos a los que se hace referencia en la ruta combinada.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿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 una cadena que contiene una ruta de acceso a Join-Path.
Salidas	System.String Join-Path devuelve una cadena que contiene la ruta de acceso resultante.

Notas

Los cmdlets que contienen el sustantivo Path (cmdlets Path) manipulan los nombres de las rutas de acceso y los devuelven con un formato conciso que todos los proveedores de Windows PowerShell saben interpretar. Se han diseñado para su uso en programas y scripts en los que se desea mostrar una ruta completa o parcial con un formato específico. Puede usarlos de la misma manera que usaría Dirname, Normpath, Realpath, Join u otros manipuladores de rutas.

Puede usar los cmdlets de rutas con varios proveedores, como FileSystem, Registry y Certificate.

El cmdlet Join-Path 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>join-path -path c:\win* -childpath System*

Descripción
-----------
Este comando usa Join-Path para combinar la ruta "c:\Win*" con la ruta secundaria "System*". El proveedor de sistema de archivos de Windows PowerShell, FileSystem, combina la ruta y agrega el delimitador "\".

Ejemplo 2

C:\PS>join-path c:\win* System* -resolve

Descripción
-----------
Este comando muestra los archivos y carpetas a los que se hace referencia combinando la ruta "c:\Win*" y la ruta secundaria "System*". Muestra los mismos archivos y carpetas que Get-ChildItem, pero se diferencia en que muestra la ruta completa de cada elemento. En este comando se omiten los nombres de parámetro opcionales Path y ChildPath.

Ejemplo 3

C:\PS>PS HKLM:\> join-path System *ControlSet* -resolve

Descripción
-----------
Este comando muestra las claves del Registro de la subclave del Registro HKLM\System que incluyen "ControlSet". En este ejemplo se muestra la forma de usar Join-Path con el proveedor Registry de Windows PowerShell.

Ejemplo 4

C:\PS>join-path -path C:, D:, E:, F: -childpath New

Descripción
-----------
Este comando utiliza Join-Path para combinar varias raíces de ruta de acceso con una ruta de acceso secundaria.

Ejemplo 5

C:\PS>get-psdrive -psprovider filesystem | foreach {$_.root} | join-path -childpath Subdir

Descripción
-----------
Este comando combina las raíces de cada unidad del sistema de archivos de Windows PowerShell en la consola con la ruta de acceso secundaria Subdir. 

El comando utiliza el cmdlet Get-PSDrive para obtener las unidades de Windows PowerShell admitidas por el proveedor FileSystem. La instrucción ForEach selecciona solo la propiedad Root de los objetos PSDriveInfo y la combina con la ruta de acceso secundaria especificada.

Los resultados muestran que las unidades de Windows PowerShell en el equipo incluían una unidad asignada al directorio C:\Archivos de programa.

Vea también

Conceptos

about_Providers
Test-Path
Split-Path
Resolve-Path
Convert-Path