Join-Path
Combine un chemin d’accès et un chemin d’accès d’enfant en un seul chemin d’accès.
Syntaxe
Default (Par défaut)
Join-Path
[-Path] <String[]>
[-ChildPath] <String>
[[-AdditionalChildPath] <String[]>]
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
Description
La cmdlet Join-Path combine un chemin d'accès et un chemin d'accès enfant en un seul chemin d'accès.
Le fournisseur fournit les délimiteurs de chemin d’accès.
Exemples
Exemple 1 : Combiner un chemin d'accès avec un chemin d'accès enfant
Join-Path -Path "path" -ChildPath "childpath"
path\childpath
Cette commande utilise Join-Path pour combiner un chemin et un chemin enfant.
Étant donné que la commande est exécutée à partir du fournisseur FileSystem, elle fournit le délimiteur \ pour joindre les chemins d’accès.
Exemple 2 : Combiner des chemins qui contiennent déjà des séparateurs de répertoires
Join-Path -Path "path\" -ChildPath "\childpath"
path\childpath
Les séparateurs de répertoires existants \ sont gérés de sorte qu’il n’existe qu’un seul séparateur entre Path et ChildPath.
Exemple 3 : Afficher des fichiers et des dossiers en joignant un chemin d’accès avec un chemin d’accès enfant
Join-Path "C:\win*" "System*" -Resolve
Cette commande affiche les fichiers et dossiers référencés en joignant le chemin d’accès C:\Win\* et le chemin d’accès enfant System\*. Il affiche les mêmes fichiers et dossiers que Get-ChildItem, mais affiche le chemin complet de chaque élément. Dans cette commande, le chemin d’accès et ChildPath noms de paramètres facultatifs sont omis.
Exemple 4 : Utiliser Join-Path avec le fournisseur de Registre PowerShell
PS HKLM:\> Join-Path -Path System -ChildPath *ControlSet* -Resolve
HKLM:\System\ControlSet001
HKLM:\System\CurrentControlSet
Cette commande affiche les clés de registre de la sous-clé de registre HKLM\System qui incluent ControlSet.
Le Résoudre paramètre, tente de résoudre le chemin joint, y compris les caractères génériques du chemin d’accès du fournisseur actuel HKLM:\
Exemple 5 : Combiner plusieurs racines de chemin d'accès avec un chemin d'accès enfant
Join-Path -Path C:, D:, E:, F: -ChildPath New
C:\New
D:\New
E:\New
F:\New
Cette commande utilise Join-Path pour combiner plusieurs racines de chemin avec un chemin enfant.
Remarque
Les lecteurs spécifiés par Chemin d’accès doivent exister ou la jointure de cette entrée échoue.
Exemple 6 : Combiner les racines d'un lecteur de système de fichiers avec un chemin d'accès enfant
Get-PSDrive -PSProvider FileSystem |
ForEach-Object {$_.Root} |
Join-Path -ChildPath "Subdir"
C:\Subdir
D:\Subdir
Cette commande combine les racines de chaque lecteur du système de fichiers PowerShell dans la console avec le chemin enfant Subdir.
La commande utilise l’applet de commande Get-PSDrive pour obtenir les lecteurs PowerShell pris en charge par le fournisseur FileSystem. L'instruction ForEach-Object sélectionne uniquement la propriété Root des objets PSDriveInfo et la combine avec le chemin enfant spécifié.
La sortie indique que les lecteurs PowerShell sur l’ordinateur comprenaient un lecteur mappé au répertoire C:\Program Files.
Exemple 7 : Combiner un nombre indéfini de chemins d’accès
Join-Path a b c d e f g
a\b\c\d\e\f\g
Le paramètre AdditionalChildPath permet de joindre un nombre illimité de chemins d’accès.
Dans cet exemple, aucun nom de paramètre n’est utilisé. Par conséquent, « a » est lié à Path, « b » à childPath et « c-g » à AdditionalChildPath.
Paramètres
-AdditionalChildPath
Spécifie des éléments supplémentaires à ajouter à la valeur du paramètre Path. Le paramètre ChildPath est toujours obligatoire et doit également être spécifié. Ce paramètre est spécifié avec la propriété ValueFromRemainingArguments, qui permet de joindre un nombre indéfini de chemins d’accès.
Ce paramètre a été ajouté dans PowerShell 6.0.
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 |
Jeux de paramètres
(All)
| Position: | 2 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-ChildPath
Spécifie les éléments à ajouter à la valeur du paramètre Path. Les caractères génériques sont autorisés.
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
(All)
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-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 |
-Path
Spécifie le chemin principal (ou chemins) auxquels le sous-chemin est ajouté. La valeur de Path détermine le fournisseur qui joint les chemins et ajoute les délimiteurs de chemin. Les caractères génériques sont autorisés.
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 |
| Alias: | PSPath |
Jeux de paramètres
(All)
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-Resolve
Indique que cette cmdlet doit tenter de résoudre le chemin joint à partir du fournisseur actuel.
- Si vous utilisez des caractères génériques, l’applet de commande retourne tous les chemins qui correspondent au chemin joint.
- Si vous n’utilisez pas de caractères génériques, l’applet de commande retourne une erreur si le chemin d’accès n’existe pas.
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 |
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 une chaîne qui contient le chemin d’accès obtenu.
Notes
Les applets de commande qui contiennent le nom path manipulent les noms de chemin 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 l’emplacement où vous souhaitez afficher tout ou partie d’un chemin d’accès dans un format particulier. Utilisez-les comme vous utiliseriez Dirname, Normpath, Realpath, Joinou d’autres manipulateurs de chemins d’accès.
Vous pouvez utiliser les cmdlets path avec plusieurs fournisseurs, notamment les fournisseurs FileSystem, Registry et Certificate.
Cette applet de commande est conçue 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, voir about_Providers.
