Join-Path
Combine un chemin d’accès et un chemin d’accès d’enfant en un seul chemin d’accès.
Join-Path
[-Path] <String[]>
[-ChildPath] <String>
[[-AdditionalChildPath] <String[]>]
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
L’applet Join-Path
de commande combine un chemin d’accès et un chemin enfant en un seul chemin.
Le fournisseur fournit les séparateurs de chemin d’accès.
PS C:\> Join-Path -Path "path" -ChildPath "childpath"
path\childpath
Cette commande utilise Join-Path
pour combiner un chemin d’accès avec un chemin d’accès enfant.
Étant donné que la commande est exécutée à partir du FileSystem
fournisseur, elle fournit le \
délimiteur pour joindre les chemins d’accès.
PS C:\> 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 C:\Win\*
chemin d’accès et le System\*
chemin enfant. Il affiche les mêmes fichiers et dossiers que Get-ChildItem
, mais affiche le chemin complet de chaque élément. Dans cette commande, les Path
noms de paramètres facultatifs et ChildPath
facultatifs sont omis.
PS HKLM:\> Join-Path -Path System -ChildPath *ControlSet* -Resolve
HKLM:\System\ControlSet001
HKLM:\System\CurrentControlSet
Cette commande affiche les clés de Registre dans la sous-clé de HKLM\System
Registre qui incluent ControlSet
.
Le Resolve
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:\
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 d’accès avec un chemin d’accès enfant.
Notes
Les lecteurs spécifiés par Path
doivent exister ou la jointure de cette entrée échouera.
Get-PSDrive -PSProvider filesystem | ForEach-Object {$_.root} | Join-Path -ChildPath "Subdir"
C:\Subdir
D:\Subdir
Cette commande combine les racines de chaque lecteur de système de fichiers PowerShell dans la console avec le chemin d’accès Subdir
enfant.
La commande utilise l’applet Get-PSDrive
de commande pour obtenir les lecteurs PowerShell pris en charge par le fournisseur FileSystem. L’instruction ForEach-Object
sélectionne uniquement la propriété Racine 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 C:\Program Files
répertoire.
Join-Path a b c d e f g
a\b\c\d\e\f\g
Le AdditionalChildPath
paramètre autorise la jointure d’un nombre illimité de chemins d’accès.
Dans cet exemple, aucun nom de paramètre n’est utilisé, donc « a » lie à Path
, « b » à ChildPath
et « c-g » à AdditionalChildPath
Spécifie des éléments supplémentaires à ajouter à la valeur du paramètre Path . Le ChildPath
paramètre est toujours obligatoire et doit également être spécifié.
Ce paramètre est spécifié avec la ValueFromRemainingArguments
propriété qui permet de joindre un nombre indéfini de chemins d’accès.
Ce paramètre a été ajouté dans PowerShell 6.0.
Type: | String[] |
Position: | 2 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
Spécifie les éléments à ajouter à la valeur du Path
paramètre. Les caractères génériques sont autorisés. Le ChildPath
paramètre est obligatoire, bien que le nom du paramètre (« ChildPath ») soit facultatif.
Type: | String |
Position: | 1 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | True |
Notes
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 |
Spécifie les chemins d’accès principaux auxquels le chemin d’accès enfant est ajouté. Les caractères génériques sont autorisés.
La valeur de Path
détermine quel fournisseur joint les chemins d’accès et ajoute les délimiteurs de chemin.
Le Path
paramètre est obligatoire, bien que le nom du paramètre (« Path ») soit facultatif.
Type: | String[] |
Alias: | PSPath |
Position: | 0 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | True |
Indique que cette applet de commande doit tenter de résoudre le chemin joint du fournisseur actuel.
- Si des caractères génériques sont utilisés, l’applet de commande retourne tous les chemins qui correspondent au chemin joint.
- Si aucun caractère générique n’est utilisé, l’applet de commande génère une erreur si le chemin d’accès n’existe pas.
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 |
Vous pouvez diriger une chaîne qui contient un chemin d’accès à cette applet de commande.
Cette applet de commande retourne une chaîne qui contient le chemin d’accès obtenu.
Les applets de commande qui contiennent le nom Path (applets de commande Path) manipulent les noms de chemin d’accès et retournent les noms dans un format concis que tous les fournisseurs PowerShell peuvent interpréter. 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 vous le feriez pour utiliser Dirname
, Normpath
, Realpath
, Join
ou d’autres manipulateurs de chemin d’accès.
Vous pouvez utiliser les applets de commande de chemin d’accès avec plusieurs fournisseurs, notamment les fournisseurs et Certificate
les FileSystem
Registry
fournisseurs.
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, consultez about_Providers.
Commentaires sur PowerShell
PowerShell est un projet open source. Sélectionnez un lien pour fournir des commentaires :