Split-Path
Devuelve la parte especificada de una ruta de acceso.
Syntax
Split-Path
[-Path] <String[]>
[-Parent]
[-Resolve]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
Split-Path
[-Path] <String[]>
[-NoQualifier]
[-Resolve]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
Split-Path
[-Path] <String[]>
[-Leaf]
[-Resolve]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
Split-Path
[-Path] <String[]>
[-Qualifier]
[-Resolve]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
Split-Path
[-Path] <String[]>
[-Resolve]
[-IsAbsolute]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
Split-Path
-LiteralPath <String[]>
[-Resolve]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
Description
El Split-Path
cmdlet 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 Resolve indica Split-Path
que muestre los elementos a los que hace referencia la ruta de acceso dividida, en lugar de mostrar la ruta de acceso dividida.
Al igual que todos los Split-Path
comandos, este comando devuelve cadenas. No devuelve objetos FileInfo que representan los archivos.
Ejemplo 3: Obtención del 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 principales de la ruta de acceso. Dado que no incluye ningún parámetro para especificar la división, Split-Path
usa el valor predeterminado de ubicación de división, que es Parent.
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 la ubicación a la carpeta que contiene el perfil de PowerShell.
El comando entre paréntesis usa Split-Path
para devolver solo el elemento primario de la ruta de acceso almacenada en la variable integrada $Profile
. El parámetro Parent es el parámetro de ubicación de división predeterminado.
Por lo tanto, puede omitirlo desde 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 se incluye entre comillas para indicar que es un único token.
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.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-IsAbsolute
Indica que este cmdlet devuelve $True
si la ruta de acceso es absoluta y $False
si es relativa. Una ruta de acceso absoluta tiene una longitud mayor que cero y no usa un punto (.
) para indicar la ruta de acceso actual.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Leaf
Indica que este cmdlet devuelve solo el último elemento o contenedor de la ruta de acceso. Por ejemplo, en la ruta de acceso C:\Test\Logs\Pass1.log
, devuelve solo Pass1.log
.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 contiene caracteres de escape, escríbalos entre comillas simples. Las comillas simples indican a PowerShell que no interprete ningún carácter como secuencias de escape.
Type: | String[] |
Aliases: | PSPath |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NoQualifier
Indica que este cmdlet devuelve la ruta de acceso sin el calificador. Para los proveedores de FileSystem o del Registro, el calificador es la unidad de la ruta de acceso del proveedor, como C:
o HKCU:
. Por ejemplo, en la ruta de acceso C:\Test\Logs\Pass1.log
, devuelve solo \Test\Logs\Pass1.log
.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 de acceso C:\Test\Logs\Pass1.log
, devuelve C:\Test\Logs
.
El parámetro Parent es el parámetro de ubicación de división predeterminado.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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íbala entre comillas. También puede canalizar una ruta de acceso a este cmdlet.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Qualifier
Indica que este cmdlet devuelve solo el calificador de la ruta de acceso especificada. Para los proveedores de FileSystem o del Registro, el calificador es la unidad de la ruta de acceso del proveedor, como C:
o HKCU:
.
Type: | SwitchParameter |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 ruta de acceso.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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, consulte about_Transactions.
Type: | SwitchParameter |
Aliases: | usetx |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Puede canalizar una cadena que contenga una ruta de acceso a este cmdlet.
Salidas
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 .
Al especificar el parámetro IsAbsolute , este cmdlet devuelve un valor booleano .
Notas
Los parámetros de ubicación dividida (Calificador, Primario, Hoja y NoQualifier) son exclusivos. y solo se puede utilizar uno en cada comando.
Los cmdlets que contienen el nombre path (cmdlets path ) funcionan con 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 su uso en programas y scripts en los que desea mostrar todo o parte de un nombre de ruta de acceso en un formato determinado. Úselos de la manera en que usaría Dirname, Normpath, Realpath, Join u otros manipuladores de rutas de acceso.
Puede usar los cmdlets 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, escribaGet-PSProvider
. Para obtener más información, consulte about_Providers.
Vínculos relacionados
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de