Split-Path
Retourne la partie spécifiée d'un chemin d'accès.
Syntaxe
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>]
Description
L'applet de commande Split-Path retourne uniquement la partie spécifiée d'un chemin d'accès (le répertoire parent, un répertoire enfant ou un nom de fichier, par exemple). Elle peut également afficher les é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 afficher ou envoyer uniquement une partie sélectionnée d'un chemin d'accès.
Paramètres
-Credential <PSCredential>
Spécifie un compte d'utilisateur qui a l'autorisation d'exécuter cette action. La valeur par défaut est l'utilisateur actuel.
Tapez un nom d'utilisateur, tel que « User01 » ou « Domain01\User01 ». Vous pouvez également entrer un objet PSCredential, tel que celui généré par l'applet de commande Get-Credential. Si vous tapez un nom d'utilisateur, vous êtes invité à entrer un mot de passe.
Ce paramètre n'est pas pris en charge par les fournisseurs installés avec Windows PowerShell.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
true (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-IsAbsolute
Retourne TRUE s'il s'agit d'un chemin d'accès absolu et FALSE en présence d'un chemin d'accès relatif. Un chemin d'accès absolu a une longueur supérieure à zéro et n'utilise pas de point ( . ) pour indiquer le chemin d'accès actuel.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Leaf
Retourne uniquement le dernier élément ou conteneur dans le chemin d'accès. Par exemple, dans le chemin d'accès « C:\Test\Logs\Pass1.log », la commande retourne uniquement « Pass1.log ».
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
true (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-LiteralPath <string[]>
Spécifie les chemins d'accès à fractionner. Contrairement à Path, la valeur de LiteralPath est utilisée exactement telle que vous la tapez. 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 à Windows PowerShell qu'aucun caractère ne doit être interprété en tant que séquence d'échappement.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
true (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-NoQualifier
Renvoie le chemin d'accès sans le qualificateur. Pour les fournisseurs FileSystem et Registry, 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 », la commande retourne uniquement « C:\Test\Logs\Pass1.log ».
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
true (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-Parent
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 », la commande retourne « C:\Test\Logs ». Parent est le paramètre d'emplacement de fractionnement par défaut.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
true (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-Path <string[]>
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 d'accès vers Split-Path.
Obligatoire ? |
true |
Position ? |
1 |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
true (ByValue, ByPropertyName) |
Accepter les caractères génériques ? |
false |
-Qualifier
Retourne uniquement le qualificateur du chemin d'accès spécifié. Pour les fournisseurs FileSystem et Registry, le qualificateur est le lecteur du chemin d'accès du fournisseur (C: ou HKCU:, par exemple).
Obligatoire ? |
false |
Position ? |
2 |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
true (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-Resolve
Affiche les éléments référencés par le chemin d'accès fractionné résultant, au lieu d'afficher les éléments du chemin d'accès.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-UseTransaction
Inclut la commande dans la transaction active. Ce paramètre est valide uniquement lorsqu'une transaction est en cours. Pour plus d'informations, consultez about_Transactions.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.
Entrées et sorties
Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.
Entrées |
System.String Vous pouvez diriger une chaîne qui contient un chemin d'accès vers Split-Path. |
Sorties |
System.String L'applet de commande Split-Path retourne des chaînes de texte. Lorsque vous utilisez le paramètre Resolve, Split-Path retourne une chaîne qui décrit l'emplacement des éléments ; elle ne retourne pas les objets qui représentent les éléments, tels qu'un objet FileInfo ou RegistryKey. |
Remarques
Les paramètres d'emplacement de fractionnement (Qualifier, Parent, Leaf et NoQualifier) sont exclusifs. Autrement dit, vous ne pouvez utiliser qu'un seul de ces paramètres dans chaque commande.
Les applets de commande contenant le nom Path (les applets de commande Path) manipulent les noms de chemin d'accès et les retournent dans un format concis pouvant être interprété par tous les fournisseurs Windows PowerShell. 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 comme Dirname, Normpath, Realpath, Join ou tout autre manipulateur de chemin d'accès.
Vous pouvez utiliser les applets de commande Path avec plusieurs fournisseurs, notamment les fournisseurs FileSystem, Registry et Certificate.
L'applet de commande Split-Path est conçue pour utiliser 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.
Exemple 1
C:\PS>split-path "HKCU:\Software\Microsoft" -qualifier
HKCU:
Description
-----------
Cette commande retourne uniquement le qualificateur (le lecteur) du chemin d'accès.
Exemple 2
C:\PS>split-path "C:\Test\Logs\*.log" -leaf -resolve
Pass1.log
Pass2.log
...
Description
-----------
Cette commande affiche les fichiers qui sont référencés par le chemin d'accès fractionné. Comme ce chemin d'accès est fractionné au niveau du dernier élément (le « nœud terminal »), seuls les noms de fichiers des chemins d'accès sont affichés.
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 d'accès fractionné.
Comme toutes les commandes Split-Path, cette commande retourne des chaînes. Elle ne retourne pas d'objets FileInfo représentant les fichiers.
Exemple 3
C:\PS>split-path "C:\WINDOWS\system32\WindowsPowerShell\V1.0\about_*.txt"
C:\WINDOWS\system32\WindowsPowerShell\V1.0
Description
-----------
Cette commande retourne uniquement les conteneurs parents du chemin d'accès. Split-Path n'inclut pas de paramètres de fractionnement et, par conséquent, elle utilise l'emplacement de fractionnement par défaut, à savoir Parent.
Exemple 4
C:\PS>split-path ".\My Pictures\*.jpg" -IsAbsolute
False
Description
-----------
Cette commande détermine si le chemin d'accès est relatif ou absolu. Dans cet exemple, le chemin d'accès est relatif au répertoire actif, représenté par un point (.) et elle retourne donc FALSE ($false).
Exemple 5
C:\PS>set-location (split-path $profile)
PS C:\Documents and Settings\juneb\My Documents\WindowsPowerShell>
Description
-----------
Cette commande change l'emplacement vers le répertoire qui contient le profil Windows PowerShell.
La commande entre parenthèses utilise l'applet de commande Split-Path pour retourner uniquement le parent du chemin d'accès stocké dans la variable $Profile intégrée. (Comme le paramètre Parent est le paramètre d'emplacement fractionné par défaut, vous pouvez l'omettre de la commande.) Les parenthèses indiquent à Windows PowerShell d'exécuter la commande en premier. Cette méthode permet d'atteindre aisément un répertoire doté d'un long nom de chemin d'accès.
Exemple 6
C:\PS>'C:\Documents and Settings\User01\My Documents\My Pictures' | split-path
C:\Documents and Settings\User01\My Documents
Description
-----------
Cette commande utilise un opérateur de pipeline (|) pour envoyer un chemin d'accès à l'applet de commande Split-Path. Le chemin d'accès figure entre guillemets pour indiquer qu'il s'agit d'un jeton unique.
Voir aussi
Concepts
about_Providers
Test-Path
Convert-Path
Resolve-Path
Join-Path