Share via

Join-Path

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

Combine un chemin d’accès et un chemin d’accès d’enfant en un seul chemin d’accès.

Syntax

Join-Path
    [-Path] <String[]>
    [-ChildPath] <String>
    [[-AdditionalChildPath] <String[]>]
    [-Resolve]
    [-Credential <PSCredential>]
    [<CommonParameters>]

Description

L’applet Join-Path de commande combine un chemin d’accès et un chemin d’accès enfant en un seul chemin. Le fournisseur fournit les séparateurs de chemin d’accès.

Exemples

Exemple 1 : Combiner un chemin avec un chemin d’accès enfant

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.

Exemple 2 : Combiner des chemins qui contiennent déjà des séparateurs de répertoires

PS C:\> Join-Path -Path "path\" -ChildPath "\childpath"

path\childpath

Séparateurs de répertoires \ existants et gérés de sorte qu’il n’y ait qu’un seul séparateur entre Path et ChildPath

Exemple 3 : Afficher des fichiers et des dossiers en joignant un chemin d’accès à 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 il affiche le chemin complet de chaque élément. Dans cette commande, les noms de Path paramètres facultatifs et ChildPath 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 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:\

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 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 é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 de système de fichiers PowerShell dans la console avec le chemin d’accès enfant Subdir.

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é Root des objets et la PSDriveInfo combine avec le chemin d’accès enfant spécifié.

La sortie indique que les lecteurs PowerShell sur l’ordinateur incluaient un lecteur mappé au répertoire C :\Program Files.

Exemple 7 : Combiner un nombre indéfini de chemins

Join-Path a b c d e f g

a\b\c\d\e\f\g

Le AdditionalChildPath paramètre permet la jointure d’un nombre illimité de chemins.

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

Type:String[]
Position:2
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ChildPath

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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Credential

Notes

Ce paramètre n’est pris en charge par aucun fournisseur installé 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
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Path

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 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[]
Aliases:PSPath
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Resolve

Indique que cette applet de commande doit tenter de résoudre le chemin joint à partir 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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

String

Vous pouvez diriger une chaîne qui contient un chemin vers cette applet de commande.

Sorties

String

Cette applet de commande retourne une chaîne qui contient le chemin d’accès résultant.

Notes

Les applets de commande qui contiennent le nom Path (applets de commande Path) manipulent les noms de chemin 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 Dirname, Normpath, Realpath, Join ou tout autre manipulateur de chemin d’accès.

Vous pouvez utiliser les applets de commande de chemin d’accès avec plusieurs fournisseurs, notamment les FileSystemfournisseurs , Registryet 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, consultez about_Providers.