Split-Path
Retourne la partie spécifiée d'un chemin d'accès.
Syntaxe
ParentSet (Par défaut)
Split-Path
[-Path] <String[]>
[-Parent]
[-Resolve]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
NoQualifierSet
Split-Path
[-Path] <String[]>
[-NoQualifier]
[-Resolve]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
LeafSet
Split-Path
[-Path] <String[]>
[-Leaf]
[-Resolve]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
QualifierSet
Split-Path
[-Path] <String[]>
[-Qualifier]
[-Resolve]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
IsAbsoluteSet
Split-Path
[-Path] <String[]>
[-Resolve]
[-IsAbsolute]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
LiteralPathSet
Split-Path
-LiteralPath <String[]>
[-Resolve]
[-Credential <PSCredential>]
[-UseTransaction]
[<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. 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
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 feuille, Split-Path retourne uniquement le dernier élément de la chaîne de chemin d’accès fournie, qu’il s’agisse d’un fichier ou d’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 Résoudre, 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 le chemin d’accès chaîne 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 Résoudre, 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, 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 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 à 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.
Propriétés du paramètre
| Type: | PSCredential |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | 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-point (..).
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
IsAbsoluteSet
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Leaf
Lorsque vous utilisez le paramètre feuille, Split-Path retourne uniquement le dernier élément de la chaîne de chemin d’accès fournie, qu’il s’agisse d’un fichier ou d’un répertoire.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
LeafSet
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-LiteralPath
Spécifie les chemins à fractionner. Contrairement à Path, la valeur de LiteralPath est utilisée exactement comme elle est saisie. 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.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | PSPath |
Jeux de paramètres
LiteralPathSet
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
NoQualifierSet
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-Parent
Split-Path retourne uniquement la partie conteneur parente de la chaîne de chemin d’accès fournie. Si le chemin d’accès chaîne ne contient pas de conteneur parent, Split-Path retourne une chaîne vide.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
ParentSet
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | True |
| DontShow: | False |
Jeux de paramètres
ParentSet
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
NoQualifierSet
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
LeafSet
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
QualifierSet
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
IsAbsoluteSet
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-Qualifier
Indique que cette applet de commande retourne uniquement le qualificateur du chemin spécifié. Pour les fournisseurs FileSystem ou Registry, le qualificateur est le lecteur du chemin d’accès du fournisseur, tel que C: ou HKCU:.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
QualifierSet
| Position: | 1 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | usetx |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
Entrées
String
Vous pouvez acheminer une chaîne contenant un chemin vers cette applet de commande.
Sorties
String
Cette applet de commande retourne des chaînes de texte. Lorsque vous spécifiez le paramètre Résoudre, 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 FileInfo ou objet 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 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-Pathest conçu pour fonctionner avec les données exposées par n’importe quel fournisseur. Pour répertorier les fournisseurs disponibles dans votre session, tapezGet-PSProvider. Pour plus d’informations, voir about_Providers.
