Join-Path

NOM
    Join-Path

RÉSUMÉ
    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 PS Credential, 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 [<SwitchParameter>]
        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 [<SwitchParameter>]
        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, WarningAction, WarningVariable,
        OutBuffer et OutVariable. Pour plus d'informations, tapez
        « get-help about_commonparameters ».

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.


NOTES


        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.






LIENS CONNEXES
    Online version: http://go.microsoft.com/fwlink/?LinkID=113347
    about_Providers
    Test-Path
    Split-Path
    Resolve-Path
    Convert-Path