Split-Path
Retourne la partie spécifiée d'un chemin d'accès.
Syntax
Split-Path
[-Path] <String[]>
[-Parent]
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
Split-Path
[-Path] <String[]>
[[-Qualifier]]
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
Split-Path
[-Path] <String[]>
[-Leaf]
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
Split-Path
[-Path] <String[]>
[-LeafBase]
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
Split-Path
[-Path] <String[]>
[-Extension]
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
Split-Path
[-Path] <String[]>
[-NoQualifier]
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
Split-Path
[-Path] <String[]>
[-Resolve]
[-IsAbsolute]
[-Credential <PSCredential>]
[<CommonParameters>]
Split-Path
-LiteralPath <String[]>
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
Description
L’applet de commande Split-Path retourne uniquement la partie spécifiée d’un chemin d’accès, comme le dossier parent, un sous-dossier ou un nom de fichier. Elle peut également obtenir des éléments qui sont référencés par le chemin d’accès fractionné et indiquer si le chemin d’accès est relatif ou absolu.
Vous pouvez utiliser cette applet de commande pour obtenir ou envoyer uniquement une partie sélectionnée d’un chemin d’accès.
Exemples
Exemple 1 : Obtenir le qualificateur d’un chemin d’accès
PS C:\> Split-Path -Path "HKCU:\Software\Microsoft" -Qualifier
HKCU:
Cette commande retourne uniquement le qualificateur du chemin d’accès. Le qualificateur est le lecteur.
Exemple 2 : Afficher les noms de fichiers
PS C:\> Split-Path -Path "C:\Test\Logs\*.log" -Leaf -Resolve
Pass1.log
Pass2.log
...
Cette commande affiche les fichiers qui sont référencés par le chemin d’accès fractionné. Étant donné que ce chemin d’accès est divisé en dernier élément, également appelé feuille, la commande affiche uniquement les noms de fichiers.
Le paramètre Resolve indique à Split-Path d’afficher les éléments référencés par le chemin d’accès fractionné au lieu d’afficher le chemin de fractionnement.
Comme toutes les commandes Split-Path , cette commande retourne des chaînes. Il ne retourne pas d’objets FileInfo qui représentent les fichiers.
Exemple 3 : Obtenir le conteneur parent
PS C:\> Split-Path -Path "C:\WINDOWS\system32\WindowsPowerShell\V1.0\about_*.txt"
C:\WINDOWS\system32\WindowsPowerShell\V1.0
Cette commande retourne uniquement les conteneurs parents du chemin d’accès. Étant donné qu’il n’inclut aucun paramètre pour spécifier le fractionnement, Split-Path utilise l’emplacement fractionné par défaut, qui est Parent.
Exemple 4 : Détermine si un chemin d’accès est absolu
PS C:\> Split-Path -Path ".\My Pictures\*.jpg" -IsAbsolute
False
Cette commande détermine si le chemin d’accès est relatif ou absolu. Dans ce cas, étant donné que le chemin d’accès est relatif au dossier actuel, qui est représenté par un point (.), il retourne $False.
Exemple 5 : Changer d’emplacement en chemin d’accès spécifié
PS C:\> Set-Location (Split-Path -Path $profile)
PS C:\Documents and Settings\User01\My Documents\WindowsPowerShell>
Cette commande modifie votre emplacement vers le dossier qui contient le profil PowerShell.
La commande entre parenthèses utilise Split-Path pour retourner uniquement le parent du chemin stocké dans la variable intégrée $Profile. Le paramètre Parent est le paramètre d’emplacement de fractionnement par défaut. Par conséquent, vous pouvez l’omettre de la commande. Les parenthèses dirigent PowerShell pour exécuter la commande en premier. Il s’agit d’un moyen utile de passer à un dossier qui a un nom de chemin d’accès long.
Exemple 6 : Fractionner un chemin à l’aide du pipeline
PS C:\> 'C:\Documents and Settings\User01\My Documents\My Pictures' | Split-Path
C:\Documents and Settings\User01\My Documents
Cette commande utilise un opérateur de pipeline (|) pour envoyer un chemin d’accès à Split-Path. Le chemin d’accès figure entre guillemets pour indiquer qu’il s’agit d’un jeton unique.
Paramètres
-Credential
Notes
Ce paramètre n’est pris en charge par aucun fournisseur installé avec PowerShell. Pour emprunter l’identité d’un autre utilisateur ou élever vos informations d’identification lors de l’exécution de cette applet de commande, utilisez Invoke-Command.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Extension
Indique que cette applet de commande retourne uniquement l’extension de la feuille.
Par exemple, dans le chemin d’accès C:\Test\Logs\Pass1.log
, elle retourne uniquement .log
.
Ce paramètre a été introduit dans PowerShell 6.0.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-IsAbsolute
Indique que cette applet de commande retourne $True si le chemin est absolu et $False s’il est relatif. Un chemin absolu a une longueur supérieure à zéro et n’utilise pas de point (.) pour indiquer le chemin actuel.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Leaf
Indique que cette applet de commande retourne uniquement le dernier élément ou le dernier conteneur dans le chemin d’accès.
Par exemple, dans le chemin d’accès C:\Test\Logs\Pass1.log
, il retourne uniquement Pass1.log.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LeafBase
Indique que cette applet de commande retourne uniquement le nom de base de la feuille.
Par exemple, dans le chemin d’accès C:\Test\Logs\Pass1.log
, elle retourne uniquement Pass1
.
Ce paramètre a été introduit dans PowerShell 6.0.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LiteralPath
Spécifie les chemins d’accès à fractionner. Contrairement au paramètre Path, la valeur de LiteralPath est utilisée exactement telle qu'elle est tapée. Aucun caractère n'est interprété en tant que caractère générique. Si le chemin d’accès inclut des caractères d’échappement, mettez-le entre des guillemets simples. Les guillemets simples indiquent à PowerShell de ne pas interpréter les caractères comme séquences d’échappement.
Type: | String[] |
Aliases: | PSPath, LP |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NoQualifier
Indique que cette applet de commande retourne le chemin sans qualificateur.
Pour les fournisseurs de système de fichiers ou de Registre, le qualificateur est le lecteur du chemin d’accès du fournisseur (C: ou HKCU:, par exemple).
Par exemple, dans le chemin d’accès C:\Test\Logs\Pass1.log
, il retourne uniquement \Test\Logs\Pass1.log.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Parent
Indique que cette applet de commande retourne uniquement les conteneurs parents de l’élément ou du conteneur spécifié par le chemin d’accès.
Par exemple, dans le chemin d’accès C:\Test\Logs\Pass1.log
, il retourne C:\Test\Logs.
Le paramètre Parent est le paramètre d’emplacement de fractionnement par défaut.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Path
Spécifie les chemins d’accès à fractionner. Les caractères génériques sont autorisés. Si le chemin d’accès inclut des espaces, mettez-le entre guillemets. Vous pouvez également diriger un chemin vers cette applet de commande.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Qualifier
Indique que cette applet de commande retourne uniquement le qualificateur du chemin d’accès spécifié. Pour les fournisseurs de système de fichiers ou de Registre, le qualificateur est le lecteur du chemin d’accès du fournisseur (C: ou HKCU:, par exemple).
Type: | SwitchParameter |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Resolve
Indique que cette applet de commande affiche les éléments référencés par le chemin de fractionnement résultant au lieu d’afficher les éléments de chemin d’accès.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entrées
Vous pouvez diriger une chaîne qui contient un chemin d’accès à cette applet de commande.
Sorties
System.String, System.Boolean
Split-Path retourne des chaînes de texte. Lorsque vous spécifiez le paramètre Resolve , Split-Path retourne une chaîne qui décrit l’emplacement des éléments ; il ne retourne pas d’objets qui représentent les éléments, tels qu’un objet FileInfo ou RegistryKey .
Lorsque vous spécifiez le paramètre IsAbsolute , Split-Path retourne une valeur booléenne .
Notes
Les paramètres d’emplacement de fractionnement (Qualificateur, Parent, Extension, Leaf, LeafBase et NoQualifier) sont exclusifs. Autrement dit, vous ne pouvez utiliser qu’un seul de ces paramètres dans chaque commande.
Les applets de commande qui contiennent le nom Path (applets de commande Path ) fonctionnent avec les noms de chemin et retournent les noms dans un format concis que tous les fournisseurs PowerShell peuvent interpréter. Elles sont conçues pour être utilisées dans des programmes et des scripts dans lesquels vous voulez afficher l’intégralité ou une partie d’un nom de chemin d’accès dans un format particulier. Utilisez-les de la façon dont vous utiliseriez Dirname, Normpath, Realpath, Join ou d’autres manipulateurs de chemins.
Vous pouvez utiliser les applets de commande Path avec plusieurs fournisseurs. Il s’agit notamment des fournisseurs FileSystem, Registry et Certificate.
Split-Path est conçu pour fonctionner avec les données exposées par n’importe quel fournisseur. Pour répertorier les fournisseurs disponibles dans votre session, tapez
Get-PSProvider
. Pour plus d'informations, consultez about_Providers.