Combine un chemin d'accès et un chemin d'accès d'enfant en un seul chemin d'accès. Le fournisseur fournit les séparateurs de chemin d'accès.
Syntaxe
Join-Path [-Path] <string[]> [-ChildPath] <string> [-Credential <PSCredential>] [-Resolve] [-UseTransaction] [<CommonParameters>]
Description
L'applet de commande Join-Path combine un chemin d'accès et un chemin d'accès d'enfant en un seul chemin d'accès. Le fournisseur fournit les séparateurs de chemin d'accès.
Paramètres
-ChildPath <string>
Spécifie les éléments à ajouter à la valeur Path. Les caractères génériques sont autorisés. Le paramètre ChildPath est requis, bien que le nom de paramètre (« ChildPath ») soit facultatif.
|
Obligatoire ? |
true |
|
Position ? |
2 |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
true (ByPropertyName) |
|
Accepter les caractères génériques ? |
false |
-Credential <PSCredential>
Spécifie un compte d'utilisateur qui a l'autorisation d'exécuter cette action. La valeur par défaut est l'utilisateur actuel.
Tapez un nom d'utilisateur, tel que « User01 » ou « Domain01\User01 ». Vous pouvez également entrer un objet PSCredential, tel que celui généré par l'applet de commande Get-Credential. Si vous tapez un nom d'utilisateur, vous êtes invité à entrer un mot de passe.
Ce paramètre n'est pas pris en charge par les fournisseurs installés avec Windows PowerShell.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
true (ByPropertyName) |
|
Accepter les caractères génériques ? |
false |
-Path <string[]>
Spécifie les chemins 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 le fournisseur qui associe les chemins d'accès et ajoute les séparateurs de chemin d'accès. Le paramètre Path est requis, bien que le nom de paramètre (« Path ») soit facultatif.
|
Obligatoire ? |
true |
|
Position ? |
1 |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
true (ByValue, ByPropertyName) |
|
Accepter les caractères génériques ? |
false |
-Resolve
Affiche les éléments qui sont référencés par le chemin d'accès associé.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
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.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.
Entrées et sorties
Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.
|
Entrées |
System.String Vous pouvez diriger une chaîne qui contient un chemin d'accès vers Join-Path. |
|
Sorties |
System.String Join-Path retourne une chaîne qui contient le chemin d'accès résultant. |
Remarques
Les applets de commande contenant le nom Path (les applets de commande Path) manipulent les noms de chemin d'accès et les retournent dans un format concis pouvant être interprété par tous les fournisseurs Windows PowerShell. 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 Path avec plusieurs fournisseurs, notamment les fournisseurs FileSystem, Registry et Certificate.
L'applet de commande Join-Path est conçue pour utiliser 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.
Exemple 1
C:\PS>join-path -path c:\win* -childpath System* Description ----------- Cette commande utilise Join-Path pour combiner le chemin d'accès « c:\Win* » avec le chemin d'accès enfant « System* ». FileSystem, le fournisseur de système de fichiers de Windows PowerShell, associe les chemins d'accès et ajoute le séparateur « \ ».
Exemple 2
C:\PS>join-path c:\win* System* -resolve Description ----------- Cette commande affiche les fichiers et les dossiers référencés en associant le chemin d'accès « c:\Win* » et le chemin d'accès enfant « System* ». Elle affiche les mêmes fichiers et dossiers que Get-ChildItem, mais elle affiche le chemin d'accès complet de chaque élément. Dans cette commande, les noms de paramètres optionnels Path et ChildPath sont omis.
Exemple 3
C:\PS>PS HKLM:\> join-path System *ControlSet* -resolve Description ----------- Cette commande affiche les clés de Registre de la sous-clé de Registre HKLM\System qui incluent « ControlSet ». Cet exemple montre comment utiliser Join-Path avec le fournisseur Registry de Windows PowerShell.
Exemple 4
C:\PS>join-path -path C:, D:, E:, F: -childpath New Description ----------- Cette commande utilise Join-Path pour combiner plusieurs racines de chemin d'accès avec un chemin d'accès enfant.
Exemple 5
C:\PS>get-psdrive -psprovider filesystem | foreach {$_.root} | join-path -childpath Subdir
Description
-----------
Cette commande combine les racines de chaque lecteur de système de fichiers Windows PowerShell dans la console avec le chemin d'accès enfant de Subdir.
La commande utilise l'applet de commande Get-PSDrive pour obtenir les lecteurs Windows PowerShell pris en charge par le fournisseur FileSystem. L'instruction ForEach sélectionne uniquement la propriété Root des objets PSDriveInfo et la combine avec le chemin d'accès enfant spécifié.
La sortie indique que les lecteurs Windows PowerShell présents sur l'ordinateur comportaient un lecteur mappé au répertoire C:\Program Files.
Voir aussi