Join-Path

  • Referencia
Módulo:
Microsoft.PowerShell.Management

Combina una ruta de acceso y una ruta de acceso secundaria en una única ruta de acceso.

Syntax

Join-Path
    [-Path] <String[]>
    [-ChildPath] <String>
    [[-AdditionalChildPath] <String[]>]
    [-Resolve]
    [-Credential <PSCredential>]
    [<CommonParameters>]

Description

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

Ejemplos

Ejemplo 1: Combinar una ruta de acceso con una ruta de acceso secundaria

PS C:\> Join-Path -Path "path" -ChildPath "childpath"

path\childpath

Este comando usa Join-Path para combinar una ruta de acceso con una ruta secundaria.

Dado que el comando se ejecuta desde el FileSystem proveedor, proporciona el \ delimitador para unir las rutas de acceso.

Ejemplo 2: Combinación de rutas de acceso que ya contienen separadores de directorio

PS C:\> Join-Path -Path "path\" -ChildPath "\childpath"

path\childpath

Los separadores de directorios \ existentes se controlan, por lo que solo hay un separador entre Path y ChildPath

Ejemplo 3: Mostrar archivos y carpetas uniendo una ruta de acceso con una ruta de acceso secundaria

Join-Path "C:\win*" "System*" -Resolve

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

Ejemplo 4: Uso de Join-Path con el proveedor del registro de PowerShell

PS HKLM:\> Join-Path -Path System -ChildPath *ControlSet* -Resolve

HKLM:\System\ControlSet001
HKLM:\System\CurrentControlSet

Este comando muestra las claves del Registro en la subclave del HKLM\System Registro que incluyen ControlSet.

El Resolve parámetro , intenta resolver la ruta de acceso combinada, incluidos los caracteres comodín de la ruta de acceso del proveedor actual. HKLM:\

Ejemplo 5: Combinar varias raíces de ruta de acceso con una ruta de acceso secundaria

Join-Path -Path C:, D:, E:, F: -ChildPath New

C:\New
D:\New
E:\New
F:\New

Este comando usa Join-Path para combinar varias raíces de ruta de acceso con una ruta de acceso secundaria.

Nota:

Las unidades especificadas por Path deben existir o se producirá un error en la combinación de esa entrada.

Ejemplo 6: Combinar las raíces de una unidad del sistema de archivos con una ruta de acceso secundaria

Get-PSDrive -PSProvider filesystem | ForEach-Object {$_.root} | Join-Path -ChildPath "Subdir"

C:\Subdir
D:\Subdir

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

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

La salida muestra que las unidades de PowerShell del equipo incluían una unidad asignada al C:\Program Files directorio.

Ejemplo 7: Combinar un número indefinido de rutas de acceso

Join-Path a b c d e f g

a\b\c\d\e\f\g

El AdditionalChildPath parámetro permite la unión de un número ilimitado de rutas de acceso.

En este ejemplo, no se usan nombres de parámetro, por lo que "a" enlaza a Path, "b" a ChildPath y "c-g" a AdditionalChildPath

Parámetros

-AdditionalChildPath

Especifica elementos adicionales que se van a anexar al valor del parámetro Path . El ChildPath parámetro sigue siendo obligatorio y también debe especificarse.

Este parámetro se especifica con la ValueFromRemainingArguments propiedad que permite unir un número indefinido de rutas de acceso.

Este parámetro se agregó en PowerShell 6.0.

Type:String[]
Position:2
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ChildPath

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

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Credential

Nota:

Este parámetro no es compatible con ningún proveedor instalado con PowerShell. Para suplantar a otro usuario o elevar las credenciales al ejecutar este cmdlet, use Invoke-Command.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Path

Especifica la ruta (o rutas) de acceso principal a la que se va a anexar la ruta de acceso secundaria. Se permiten los caracteres comodín.

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

Type:String[]
Aliases:PSPath
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Resolve

Indica que este cmdlet debe intentar resolver la ruta de acceso combinada del proveedor actual.

  • Si se usan caracteres comodín, el cmdlet devuelve todas las rutas de acceso que coinciden con la ruta de acceso combinada.
  • Si no se usan caracteres comodín, el cmdlet producirá un error si la ruta de acceso no existe.
Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

String

Puede canalizar una cadena que contenga una ruta de acceso a este cmdlet.

Salidas

String

Este cmdlet devuelve una cadena que contiene la ruta de acceso resultante.

Notas

Los cmdlets que contienen el nombre path (cmdlets path) manipulan los nombres de ruta de acceso y devuelven los nombres en un formato conciso que todos los proveedores de PowerShell pueden interpretar. Están diseñados para usarse en programas y scripts en los que se quiere mostrar un nombre de ruta de acceso completo o parte de él en un formato determinado. Úselos como usaría Dirname, Normpath, Realpath, Joinu otros manipuladores de ruta de acceso.

Puede usar los cmdlets de ruta de acceso con varios proveedores, incluidos los FileSystemproveedores , Registryy Certificate .

Este cmdlet 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, consulte about_Providers.