Compartir a través de


Split-Path

Devuelve la parte especificada de una ruta de acceso.

Sintaxis

ParentSet (valor predeterminado)

Split-Path
    [-Path] <String[]>
    [-Parent]
    [-Resolve]
    [-Credential <PSCredential>]
    [<CommonParameters>]

LeafSet

Split-Path
    [-Path] <String[]>
    -Leaf
    [-Resolve]
    [-Credential <PSCredential>]
    [<CommonParameters>]

LeafBaseSet

Split-Path
    [-Path] <String[]>
    -LeafBase
    [-Resolve]
    [-Credential <PSCredential>]
    [<CommonParameters>]

ExtensionSet

Split-Path
    [-Path] <String[]>
    -Extension
    [-Resolve]
    [-Credential <PSCredential>]
    [<CommonParameters>]

QualifierSet

Split-Path
    [-Path] <String[]>
    -Qualifier
    [-Resolve]
    [-Credential <PSCredential>]
    [<CommonParameters>]

NoQualifierSet

Split-Path
    [-Path] <String[]>
    -NoQualifier
    [-Resolve]
    [-Credential <PSCredential>]
    [<CommonParameters>]

IsAbsoluteSet

Split-Path
    [-Path] <String[]>
    -IsAbsolute
    [-Resolve]
    [-Credential <PSCredential>]
    [<CommonParameters>]

LiteralPathSet

Split-Path
    -LiteralPath <String[]>
    [-Resolve]
    [-Credential <PSCredential>]
    [<CommonParameters>]

Description

El cmdlet Split-Path devuelve solo la parte especificada de una ruta de acceso, como la carpeta primaria, una subcarpeta o un nombre de archivo. También puede obtener elementos a los que hace referencia la ruta de acceso dividida e indicar si la ruta de acceso es relativa o absoluta.

Puede usar este cmdlet para obtener o enviar solo una parte seleccionada de una ruta de acceso.

Ejemplos

Ejemplo 1: Obtener el calificador de una ruta de acceso

Split-Path -Path "HKCU:\Software\Microsoft" -Qualifier
HKCU:

Este comando devuelve solo el calificador de la ruta de acceso. El calificador es la unidad.

Ejemplo 2: Mostrar nombres de archivo

Split-Path -Path "C:\Test\Logs\*.log" -Leaf -Resolve
Pass1.log
Pass2.log
...

Este comando muestra los archivos a los que hace referencia la ruta de acceso dividida. Dado que esta ruta de acceso se divide en el último elemento, también conocido como hoja, el comando muestra solo los nombres de archivo.

El parámetro Resolver indica Split-Path que se muestren los elementos a los que hace referencia la ruta de división, en lugar de mostrar la ruta de división.

Como todos los Split-Path comandos, este comando devuelve cadenas. No devuelve objetos FileInfo que representan los archivos.

Ejemplo 3: Obtener el contenedor primario

Split-Path -Parent "C:\WINDOWS\system32\WindowsPowerShell\V1.0\about_*.txt"
C:\WINDOWS\system32\WindowsPowerShell\V1.0

Este comando devuelve solo los contenedores primarios de la ruta de acceso. Dado que no incluye ningún parámetro para especificar la división, Split-Path usa la ubicación predeterminada de división, que es Primario.

Ejemplo 4: Determina si una ruta de acceso es absoluta

Split-Path -Path ".\My Pictures\*.jpg" -IsAbsolute
False

Este comando determina si la ruta de acceso es relativa o absoluta. En este caso, dado que la ruta de acceso es relativa a la carpeta actual, que se representa mediante un punto (.), devuelve $False.

Ejemplo 5: Cambiar la ubicación a una ruta de acceso especificada

PS C:\> Set-Location (Split-Path -Path $profile)
PS C:\Documents and Settings\User01\My Documents\WindowsPowerShell>

Este comando cambia tu ubicación a la carpeta que contiene el perfil de PowerShell.

El comando entre paréntesis utiliza Split-Path para devolver solo el elemento padre de la ruta de acceso almacenada en la variable integrada $Profile. El parámetro Parent es el parámetro de ubicación dividida predeterminado. Por lo tanto, puede omitirlo en el comando. Los paréntesis dirigen PowerShell para ejecutar primero el comando. Se trata de una manera útil de moverse a una carpeta que tiene un nombre de ruta de acceso largo.

Ejemplo 6: Dividir una ruta de acceso mediante la canalización

'C:\Documents and Settings\User01\My Documents\My Pictures' | Split-Path
C:\Documents and Settings\User01\My Documents

Este comando usa un operador de canalización (|) para enviar una ruta de acceso a Split-Path. La ruta de acceso está entre comillas para indicar que es un token único.

Parámetros

-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.

Propiedades de parámetro

Tipo:PSCredential
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Extension

Indica que este cmdlet devuelve solo la extensión de la hoja. Por ejemplo, en la ruta C:\Test\Logs\Pass1.log, devuelve solo .log.

Este parámetro se introdujo en PowerShell 6.0.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ExtensionSet
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-IsAbsolute

Indica que este cmdlet devuelve $True si la ruta de acceso es absoluta y $False si es relativa. Una ruta absoluta tiene una longitud mayor que cero y no usa un punto (.) para indicar la ruta actual.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

IsAbsoluteSet
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Leaf

Indica que este cmdlet devuelve solo el último elemento o contenedor de la ruta de acceso. Por ejemplo, en la ruta C:\Test\Logs\Pass1.log, devuelve solo Pass1.log.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

LeafSet
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-LeafBase

Indica que este cmdlet devuelve solo el nombre base de la hoja. Por ejemplo, en la ruta C:\Test\Logs\Pass1.log, devuelve solo Pass1.

Este parámetro se introdujo en PowerShell 6.0.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

LeafBaseSet
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-LiteralPath

Especifica las rutas de acceso que se van a dividir. A diferencia de Path, el valor de LiteralPath se usa exactamente como se escribe. Ningún carácter se interpreta como 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.

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:PSPath, LP

Conjuntos de parámetros

LiteralPathSet
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-NoQualifier

Indica que este cmdlet devuelve la ruta de acceso sin el calificador. Para los proveedores del sistema de archivos o del Registro, el calificador es la unidad de la ruta de acceso del proveedor, como C: o HKCU:. Por ejemplo, en la ruta C:\Test\Logs\Pass1.log, devuelve solo \Test\Logs\Pass1.log.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

NoQualifierSet
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Parent

Indica que este cmdlet devuelve solo los contenedores primarios del elemento o del contenedor especificado por la ruta de acceso. Por ejemplo, en la ruta C:\Test\Logs\Pass1.log, devuelve C:\Test\Logs. El parámetro Parent es el parámetro de ubicación dividida predeterminado.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ParentSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Path

Especifica las rutas de acceso que se van a dividir. Se permite el uso de caracteres comodín. Si la ruta de acceso incluye espacios, escríbalo entre comillas. También puede canalizar una ruta de acceso a este cmdlet.

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:True
DontShow:False

Conjuntos de parámetros

ParentSet
Posición:0
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False
LeafSet
Posición:0
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False
LeafBaseSet
Posición:0
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False
ExtensionSet
Posición:0
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False
QualifierSet
Posición:0
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False
NoQualifierSet
Posición:0
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False
IsAbsoluteSet
Posición:0
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Qualifier

Indica que este cmdlet devuelve solo el calificador de la ruta de acceso especificada. Para los proveedores del sistema de archivos o del Registro, el calificador es la unidad de la ruta de acceso del proveedor, como C: o HKCU:.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

QualifierSet
Posición:1
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Resolve

Indica que este cmdlet muestra los elementos a los que hace referencia la ruta de acceso dividida resultante en lugar de mostrar los elementos de la ruta.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

String

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

Salidas

String

Este cmdlet devuelve cadenas de texto. Al especificar el parámetro Resolve, devuelve una cadena que describe la ubicación de los elementos. No devuelve objetos que representan los elementos, como un objeto FileInfo o RegistryKey.

Boolean

Al especificar el parámetro isAbsolute, este cmdlet devuelve un valor de booleano.

Notas

  • Los parámetros de ubicación dividida (Qualifier, Parent, Extension, Leaf, LeafBase y NoQualifier) son exclusivos. Solamente puede usar uno en cada comando.

  • Los cmdlets que contienen el sustantivo Path (los cmdlets Path) trabajan con nombres de rutas y devuelven los nombres en un formato conciso que todos los proveedores de PowerShell pueden interpretar. Están diseñados para su uso en programas y scripts en los que desea mostrar todo o parte de una ruta en un formato determinado. Úselos de la manera en que usaría Dirname, Normpath, Realpath, Joinu otros manipuladores de rutas.

  • Puede usar los cmdlets de Path junto con varios proveedores. Estos incluyen los proveedores FileSystem, Registry y Certificate.

  • Split-Path 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.