Devuelve la parte especificada de una ruta.
Sintaxis
Split-Path [-IsAbsolute] [-Path] <string[]> [-Credential <PSCredential>] [-LiteralPath <string[]>] [-Resolve] [-UseTransaction] [<CommonParameters>] Split-Path [-Leaf] [-Path] <string[]> [-Credential <PSCredential>] [-LiteralPath <string[]>] [-Resolve] [-UseTransaction] [<CommonParameters>] Split-Path [-NoQualifier] [-Path] <string[]> [-Credential <PSCredential>] [-LiteralPath <string[]>] [-Resolve] [-UseTransaction] [<CommonParameters>] Split-Path [-Parent] [-Path] <string[]> [-Credential <PSCredential>] [-LiteralPath <string[]>] [-Resolve] [-UseTransaction] [<CommonParameters>] Split-Path [-Qualifier] [-Path] <string[]> [-Credential <PSCredential>] [-LiteralPath <string[]>] [-Resolve] [-UseTransaction] [<CommonParameters>]
Descripción
El cmdlet Split-Path devuelve sólo la parte especificada de una ruta de acceso, como el directorio primario, un directorio secundario o un nombre de archivo. También puede mostrar los elementos a los que se hace referencia en la ruta de acceso dividida e indicar si la ruta de acceso es relativa o absoluta.
Puede utilizar este cmdlet para mostrar o enviar sólo una parte seleccionada de una ruta de acceso.
Parámetros
-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 |
-IsAbsolute
Devuelve TRUE si la ruta es absoluta y FALSE si es relativa. Una ruta de acceso absoluta tiene una longitud mayor que cero y no utiliza un punto (.) para indicar la ruta de acceso actual.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Leaf
Devuelve únicamente el último elemento o contenedor de la ruta. Por ejemplo, en la ruta "C:\Test\Logs\Pass1.log", solo devuelve "Pass1.log".
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByPropertyName) |
|
¿Aceptar caracteres comodín? |
false |
-LiteralPath <string[]>
Especifica las rutas que se van a dividir. A diferencia de Path, el valor de LiteralPath se usa literalmente 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? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByPropertyName) |
|
¿Aceptar caracteres comodín? |
false |
-NoQualifier
Devuelve la ruta sin el calificador. Para los proveedores FileSystem o Registry, el calificador es la unidad de la ruta del proveedor, como C: o HKCU:. Por ejemplo, en la ruta "C:\Test\Logs\Pass1.log", sólo devuelve "\Test\Logs\Pass1.log".
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByPropertyName) |
|
¿Aceptar caracteres comodín? |
false |
-Parent
Devuelve únicamente los contenedores principales del elemento o del contenedor especificado en la ruta. Por ejemplo, en la ruta "C:\Test\Logs\Pass1.log", devuelve "C:\Test\Logs". El parámetro Parent es el parámetro de la ubicación de división predeterminada.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByPropertyName) |
|
¿Aceptar caracteres comodín? |
false |
-Path <string[]>
Especifica las rutas que se van a dividir. Se permite el uso de caracteres comodín. Si la ruta contiene espacios, escríbala entre comillas. También puede canalizar una ruta de acceso a Split-Path.
|
¿Requerido? |
true |
|
¿Posición? |
1 |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByValue, ByPropertyName) |
|
¿Aceptar caracteres comodín? |
false |
-Qualifier
Devuelve únicamente el calificador de la ruta especificada. Para los proveedores FileSystem o Registry, el calificador es la unidad de la ruta del proveedor, como C: o HKCU:.
|
¿Requerido? |
false |
|
¿Posición? |
2 |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByPropertyName) |
|
¿Aceptar caracteres comodín? |
false |
-Resolve
Muestra los elementos a los que se hace referencia en la ruta de acceso dividida resultante, en lugar de mostrar los elementos de la ruta de acceso.
|
¿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 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 una cadena que contiene una ruta de acceso a Split-Path. |
|
Salidas |
System.String El cmdlet Split-Path devuelve cadenas de texto. Al utilizar el parámetro Resolve, Split-Path devuelve una cadena que describe la ubicación de los elementos; no devuelve objetos que representan los elementos, como un objeto FileInfo o RegistryKey. |
Notas
Los parámetros de ubicación de división (Qualifier, Parent, Leaf y NoQualifier) son mutuamente excluyentes. No puede usar más de uno en cada comando.
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 Path con varios proveedores, como FileSystem, Registry y Certificate.
El cmdlet Split-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>split-path "HKCU:\Software\Microsoft" -qualifier HKCU: Descripción ----------- Este comando devuelve únicamente el calificador (la unidad) de la ruta.
Ejemplo 2
C:\PS>split-path "C:\Test\Logs\*.log" -leaf -resolve
Pass1.log
Pass2.log
...
Descripción
-----------
Este comando muestra los archivos a los que se hace referencia en la ruta de acceso dividida. Como esta ruta de acceso se divide en el último elemento ("hoja"), sólo se muestran los nombres de archivo de las rutas de acceso.
El parámetro Resolve notifica a Split-Path que muestre los elementos a los que se hace referencia en la ruta de acceso dividida, en lugar de mostrar la ruta de acceso dividida.
Como todos los comandos Split-Path, este comando devuelve cadenas. No devuelve objetos FileInfo que representan los archivos.
Ejemplo 3
C:\PS>split-path "C:\WINDOWS\system32\WindowsPowerShell\V1.0\about_*.txt" C:\WINDOWS\system32\WindowsPowerShell\V1.0 Descripción ----------- Este comando devuelve únicamente los contenedores primarios de la ruta. Como no incluye ningún parámetro para especificar la división, Split-Path usa el valor predeterminado de la ubicación de división, que es Parent.
Ejemplo 4
C:\PS>split-path ".\My Pictures\*.jpg" -IsAbsolute False Descripción ----------- Este comando determina si la ruta es relativa o absoluta. En este caso, como la ruta es relativa al directorio actual, que se representa mediante un punto (.), devuelve FALSE ($false).
Ejemplo 5
C:\PS>set-location (split-path $profile) PS C:\Documents and Settings\juneb\My Documents\WindowsPowerShell> Descripción ----------- Este comando cambia la ubicación al directorio que contiene el perfil de Windows PowerShell. El comando entre paréntesis usa el cmdlet Split-Path para devolver únicamente el contenedor principal de la ruta almacenada en la variable $Profile integrada. (El parámetro Parent es el parámetro de ubicación de división predeterminada, por lo que se puede omitir en el comando). Los paréntesis hacen que Windows PowerShell ejecute primero el comando. Esto resulta útil para desplazar hasta un directorio con una ruta larga.
Ejemplo 6
C:\PS>'C:\Documents and Settings\User01\My Documents\My Pictures' | split-path C:\Documents and Settings\User01\My Documents Descripción ----------- Este comando utiliza un operador de canalización (|) para enviar una ruta de acceso al cmdlet Split-Path. La ruta de acceso se incluye entre comillas para indicar que es un solo token.
Vea también