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>]
     [-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

La cmdlet 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. Il peut également obtenir des éléments référencés par le chemin de fractionnement et indiquer si le chemin 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 référencés par le chemin de fractionnement. É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 Résoudre indique fractionner le chemin d’accès pour afficher les éléments référencés par le chemin de fractionnement, au lieu d’afficher le chemin de fractionnement.

Comme toutes les commandes Split-Path, cette commande retourne des chaînes. Il ne retourne pas 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, de fractionnement utilise l’emplacement de fractionnement 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 actif, qui est représenté par un point (.), il retourne $False.

Exemple 5 : Modifier l’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 remplace votre emplacement par 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 $Profile intégrée. 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

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 est placé entre guillemets pour indiquer qu’il s’agit d’un seul jeton.

Paramètres

-Credential

Note

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

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

-Leaf

Indique que cette applet de commande 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, elle retourne uniquement Pass1.log.

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

-LiteralPath

Spécifie les chemins à fractionner. Contrairement à Path, la valeur de LiteralPath est utilisée exactement comme il est typé. Aucun caractère n’est interprété comme des caractères génériques. Si le chemin inclut des caractères d’échappement, placez-le entre guillemets simples. Les guillemets simples indiquent à PowerShell de ne pas interpréter de caractères comme séquences d’échappement.

Type:String[]
Alias:PSPath
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, il retourne uniquement \Test\Logs\Pass1.log.

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

-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, elle retourne C :\Test\Logs. Le paramètre parent est le paramètre d’emplacement de fractionnement par défaut.

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 à fractionner. Les caractères génériques sont autorisés. Si le chemin inclut des espaces, placez-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:False
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

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

Type:SwitchParameter
Alias:usetx
Position:Named
Valeur par défaut:False
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

System.String, System.Boolean

de chemin d’accès fractionné retourne des chaînes de texte. Lorsque vous spécifiez le paramètre Résoudre, fractionner le chemin d’accès 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 FileInfo ou Objet RegistryKey.

Lorsque vous spécifiez le paramètre IsAbsolute , split-path retourne une valeur de booléenne .

Notes

  • Les paramètres d’emplacement de fractionnement (Qualificateur, parent, Leaf et NoQualifier) sont exclusifs. Vous ne pouvez utiliser qu’une seule commande dans chaque commande.

    Les applets de commande qui contiennent le chemin d’accès nom (les 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 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.