Partager via

Split-Path

  • Référence
Module:
Microsoft.PowerShell.Management

Retourne la partie spécifiée d'un chemin d'accès.

Syntaxe

Split-Path
     [-Path] <String[]>
     [-Parent]
     [-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[]>
     -Qualifier
     [-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 Split-Path de commande 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. Si vous fractionnez un chemin sans spécifier d’autres paramètres, Split-Path retourne la partie parente du chemin fourni.

La Split-Path commande retourne des chaînes. Il ne retourne pas FileInfo ou d’autres objets d’élément comme les *-Item commandes.

Exemples

Exemple 1 : Obtenir le qualificateur d’un chemin d’accès

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 la partie nom de fichier du chemin d’accès

Lorsque vous utilisez le paramètre Leaf , Split-Path retourne uniquement le dernier élément de la chaîne de chemin d’accès fournie, que cet élément soit un fichier ou un répertoire.

Split-Path -Path .\folder1\*.txt -Leaf

*.txt

Split-Path -Path .\folder1\*.txt -Leaf -Resolve

file1.txt
file2.txt

Lorsque vous utilisez le paramètre Resolve , Split-Path résout la chaîne de chemin d’accès fournie et retourne les éléments référencés par le chemin d’accès.

Exemple 3 : Obtenir le conteneur parent

Lorsque vous utilisez le paramètre Parent , Split-Path retourne uniquement la partie conteneur parente de la chaîne de chemin d’accès fournie. Si la chaîne Path ne contient pas de conteneur parent, Split-Path retourne une chaîne vide.

Split-Path -Path .\folder1\file1.txt -Parent

.\folder1

Split-Path -Path .\folder1\file1.txt -Parent -Resolve

D:\temp\test\folder1

Lorsque vous utilisez le paramètre Resolve , Split-Path résout la chaîne de chemin d’accès fournie et retourne le chemin d’accès complet du conteneur parent.

Exemple 4 : détermine si un chemin d’accès est absolu

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 actif, qui est représenté par un point (.), il retourne $False.

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

False

Exemple 5 : Modifier l’emplacement en chemin d’accès spécifié

Cette commande remplace votre emplacement par le dossier qui contient le profil PowerShell.

PS C:\> Set-Location (Split-Path -Path $profile)
PS C:\Users\User01\Documents\PowerShell>

La commande entre parenthèses utilise Split-Path pour renvoyer 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 à partir 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

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

C:\Users\User01\My Documents

Cette commande utilise un opérateur de pipeline (|) pour envoyer un chemin d’accès à Split-Path. Le chemin est placé entre guillemets pour indiquer qu’il s’agit d’un seul jeton.

Paramètres

-Credential

Remarque

Ce paramètre n’est pas pris en charge par les fournisseurs installés 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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-IsAbsolute

Indique que cette applet de commande retourne $True si le chemin est absolu et $False s’il est relatif. Sur Windows, une chaîne de chemin d’accès absolu doit commencer par un spécificateur de lecteur de fournisseur, comme C: ou HKCU:. Un chemin relatif commence par un point (.) ou un point (..).

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Leaf

Lorsque vous utilisez le paramètre Leaf , Split-Path retourne uniquement le dernier élément de la chaîne de chemin d’accès fournie, que cet élément soit un fichier ou un répertoire.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-LiteralPath

Spécifie les chemins d’accès à fractionner. Contrairement à Path, la valeur de LiteralPath est utilisée exactement comme elle est typé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 de caractères comme séquences d’échappement.

Type:String[]
Alias:PSPath, LP
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-NoQualifier

Indique que cette applet de commande retourne le chemin d’accès sans qualificateur. Pour les fournisseurs FileSystem ou de Registre, le qualificateur est le lecteur du chemin d’accès du fournisseur, tel que C: ou HKCU:. Par exemple, dans le chemin d’accès C:\Test\Logs\Pass1.log, elle retourne uniquement \Test\Logs\Pass1.log.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Parent

Split-Path retourne uniquement la partie conteneur parente de la chaîne de chemin d’accès fournie. Si la chaîne Path ne contient pas de conteneur parent, Split-Path retourne une chaîne vide.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:True

-Qualifier

Indique que cette applet de commande retourne uniquement le qualificateur du chemin spécifié. Pour les fournisseurs FileSystem ou de Registre, le qualificateur est le lecteur du chemin d’accès du fournisseur, tel que C: ou HKCU:.

Type:SwitchParameter
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Resolve

Indique que cette applet de commande affiche les éléments référencés par le chemin de fractionnement obtenu au lieu d’afficher les éléments de chemin d’accès.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

String

Vous pouvez diriger une chaîne qui contient un chemin d’accès à cette applet de commande.

Sorties

String

Cette applet de commande retourne des chaînes de texte. Lorsque vous spécifiez le paramètre Resolve , il 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 .

Boolean

Lorsque vous spécifiez le paramètre IsAbsolute , cette applet de commande retourne une valeur booléenne .

Notes

  • Les paramètres d’emplacement fractionné (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 d’accès et retournent les noms dans un format concis que tous les fournisseurs PowerShell peuvent interpréter. Ils sont conçus pour être utilisés dans les programmes et les scripts dans lesquels vous souhaitez afficher tout ou 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 chemin d’accès.

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