Flash info

"Les IT Pros sont en train de migrer rapidement car PowerShell est plus facile et plus puissant que VBScript."

Microsoft Scripting Guys

 
Aide mémoire - *-Path
Écrit par Arnaud Petitjean [MVP]   
12-12-2006

Convert-Path

Join-Path Resolve-Path Split-Path Test-Path

NOM
    Convert-Path

   
RÉSUMÉ
    Convertit un chemin d'accès Windows PowerShell en chemin d'accès à un fournisseur de Windows PowerShell.
   
   
SYNTAXE
    Convert-Path [-path] <string[]> [<CommonParameters>]
   
    Convert-Path [-literalPath] <string[]> [<CommonParameters>]
   
   
DESCRIPTION DÉTAILLÉE
    Convertit un chemin d'accès Windows PowerShell en chemin d'accès à un fournisseur de Windows PowerShell.
   

PARAMÈTRES
    -path <string[]>
        Spécifie le chemin d'accès Windows PowerShell à convertir.
       
    -literalPath <string[]>
        Spécifie le chemin d'accès à convertir. La valeur de -LiteralPath est utilisée exactement telle que vous la tapez. Aucun caractère n'est interprété en tant que caractère générique. Si le chemin d'accès inclut des caractères d'échappement, mettez-le entre des guillemets simples. Les guillemets simples indiquent à Windows PowerShell qu'aucun caractère ne doit être interprété en tant que séquence d'échappement.
       
    <CommonParameters>
        Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug,
        -ErrorAction, -ErrorVariable et -OutVariable. Pour plus d'informations,
        tapez « get-help about_commonparameters ».
   
    -------------------------- EXEMPLE 1 --------------------------
   
    C:\PS>convert-path ~
   
    Cette commande développe le répertoire de travail actif.
   
   
   
   
    -------------------------- EXEMPLE 2 --------------------------
   
    C:\PS>convert-path HKLM:\software\microsoft
   
    Cette commande convertit le chemin d'accès au fournisseur de Windows PowerShell en chemin d'accès standard au Registre.
   
   
   
   
REMARQUES
    Pour plus d'informations, tapez : "get-help Convert-Path -detailed".
    Pour obtenir des informations techniques, tapez : "get-help Convert-Path -full".
 


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> [-resolve] [-credential <PSCredential>] [<CommonParameters>]
   
   
DESCRIPTION DÉTAILLÉE
    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
    -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.
       
    -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.
       
    -resolve <SwitchParameter>
        Affiche les éléments qui sont référencés par le chemin d'accès associé.
       
    -credential <PSCredential>
        Utilise des informations d'identification pour valider l'accès à la ressource. <Credential> représente un nom d'utilisateur, tel que " Utilisateur01 " ou " Domaine01\Utilisateur01 ", ou un objet PSCredential, tel que celui récupéré à l'aide de l'applet de commande Get-Credential. Si vous tapez un nom d'utilisateur, vous êtes invité à entrer un mot de passe. Ce paramètre s'affiche, mais il n'est pas pris en charge par les applets de commande principales et les fournisseurs de Windows PowerShell.
       
    <CommonParameters>
        Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug,
        -ErrorAction, -ErrorVariable et -OutVariable. Pour plus d'informations,
        tapez « get-help about_commonparameters ».
   
    -------------------------- EXEMPLE 1 --------------------------
   
    C:\PS>join-path -path c:\win* -childpath System*
   
    Cette commande utilise Join-Path pour combiner le chemin d'accès " c:\Win* " avec le chemin d'accès enfant " Système* ". FileSystem, le fournisseur de système de fichiers de Windows PowerShell, associe les chemins d'accès et ajoute le séparateur " \ ".
   
   
    c:\win*\System*
   
    -------------------------- EXEMPLE 2 --------------------------
   
    C:\PS>join-path c:\win* System* -resolve
   
    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 " Système* ". 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ètre optionnels Path et Childpath sont omis.
   
   
    C:\WINDOWS\system
    C:\WINDOWS\system32
    C:\WINDOWS\system.ini
   
    -------------------------- EXEMPLE 3 --------------------------
   
    C:\PS>PS HKLM:\> join-path System *ControlSet* -resolve
   
    Cette commande affiche les clés de Registre de la ruche HKLM\System qui incluent " ControlSet ". Cet exemple montre comment utiliser Join-Path avec le fournisseur Registry de Windows PowerShell.
   
   
    HKLM:\System\ControlSet001
    HKLM:\System\ControlSet002
    HKLM:\System\CurrentControlSet
   
REMARQUES
    Pour plus d'informations, tapez : "get-help Join-Path -detailed".
    Pour obtenir des informations techniques, tapez : "get-help Join-Path -full".


NOM
    Resolve-Path
   
RÉSUMÉ
    Résout les caractères génériques inclus dans un chemin d'accès et affiche le contenu de ce dernier.
   
   
SYNTAXE
    Resolve-Path [-path] <string[]> [-credential <PSCredential>] [<CommonParameters>]
   
    Resolve-Path [-literalPath] <string[]> [-credential <PSCredential>] [<CommonParameters>]
   
   
DESCRIPTION DÉTAILLÉE
    Interprète les caractères génériques inclus dans un chemin d'accès et affiche les éléments et les conteneurs à l'emplacement qu'il spécifie, tels que les fichiers et les dossiers ou les clés et les sous-clés de Registre. Les noms s'affichent exactement tels qu'ils sont représentés sur le lecteur, en respectant la casse.
   

PARAMÈTRES
    -path <string[]>
        Spécifie le chemin d'accès Windows PowerShell à résoudre.
       
    -credential <PSCredential>
        Utilise des informations d'identification pour valider l'accès à la ressource. <Credential> représente un nom d'utilisateur, tel que " Utilisateur01 " ou " Domaine01\Utilisateur01 ", ou un objet PSCredential, tel que celui récupéré à l'aide de l'applet de commande Get-Credential. Si vous tapez un nom d'utilisateur, vous êtes invité à entrer un mot de passe. Ce paramètre s'affiche, mais il n'est pas pris en charge par les applets de commande principales et les fournisseurs de Windows PowerShell.
       
    -literalPath <string[]>
        Spécifie le chemin d'accès à résoudre. La valeur de -LiteralPath est utilisée exactement telle que vous la tapez. Aucun caractère n'est interprété en tant que caractère générique. Si le chemin d'accès inclut des caractères d'échappement, mettez-le entre des guillemets simples. Les guillemets simples indiquent à Windows PowerShell qu'aucun caractère ne doit être interprété en tant que séquence d'échappement.
       
    <CommonParameters>
        Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug,
        -ErrorAction, -ErrorVariable et -OutVariable. Pour plus d'informations,
        tapez « get-help about_commonparameters ».
   
    -------------------------- EXEMPLE 1 --------------------------
   
    C:\PS>resolve-path ~ | format-list
   
    Le caractère ~ correspond au chemin d'accès de base. Cet exemple retourne le chemin d'accès de base complet.
   
   
    Lecteur : C
    Fournisseur : System.Management.Automation.ProviderInfo
    Chemin d'accès au fournisseur : C:\Documents and Settings\nom_utilisateur
    Chemin d'accès : C:\Documents and Settings\nom_utilisateur
   
    -------------------------- EXEMPLE 2 --------------------------
   
    C:\PS>resolve-path windows\*| format-list
   
    Cet exemple démarre à l'emplacement actuel et retourne les chemins d'accès à tous les éléments contenus dans le dossier Windows. Dans ce cas précis, il n'y en a qu'un seul.
   
   
    Lecteur  C
    Fournisseur : System.Management.Automation.ProviderInfo
    Chemin d'accès au fournisseur : C:\Documents and Settings\nom_utilisateur\windows\system
    Chemin d'accès : C:\Documents and Settings\nom_utilisateur\windows\system
   
    -------------------------- EXEMPLE 3 --------------------------
   
    C:\PS>resolve-path "C:\windows\*"| format-list
   
    Cet exemple recherche le dossier C:\Windows et retourne les chemins d'accès à l'ensemble des éléments qu'il contient. Notez l'insertion du chemin d'accès entre des guillemets, pour indiquer qu'il est différent de l'emplacement actuel.
   
   
    Lecteur : C
    Fournisseur : System.Management.Automation.ProviderInfo
    Chemin d'accès au fournisseur : C:\windows\addins
    Chemin d'accès : C:\windows\addins
   
    Lecteur : C
    Fournisseur : System.Management.Automation.ProviderInfo
    Chemin d'accès au fournisseur : C:\windows\AppPatch
    Chemin d'accès : C:\windows\AppPatch
   
    Lecteur : C
    Fournisseur : System.Management.Automation.ProviderInfo
    Chemin d'accès au fournisseur : C:\windows\assembly
    Chemin d'accès : C:\windows\assembly
    ...
   
REMARQUES
    Pour plus d'informations, tapez : "get-help Resolve-Path -detailed".
    Pour obtenir des informations techniques, tapez : "get-help Resolve-Path -full".



NOM
    Split-Path
   
RÉSUMÉ
    Retourne la partie spécifiée d'un chemin d'accès.
   
   
SYNTAXE
    Split-Path [-path] <string[]> [-parent] [-resolve] [-credential <PSCredential>] [-literalPath <string[]>] [<CommonParameters>]
   
    Split-Path [-path] <string[]> [[-qualifier]] [-resolve] [-credential <PSCredential>] [-literalPath <string[]>] [<CommonParameters>]
   
    Split-Path [-path] <string[]> [-noQualifier] [-resolve] [-credential <PSCredential>] [-literalPath <string[]>] [<CommonParameters>]
   
    Split-Path [-path] <string[]> [-leaf] [-resolve] [-credential <PSCredential>] [-literalPath <string[]>] [<CommonParameters>]
   
    Split-Path [-path] <string[]> [-isAbsolute] [-resolve] [-credential <PSCredential>] [-literalPath <string[]>] [<CommonParameters>]
   
   
DESCRIPTION DÉTAILLÉE
    L'applet de commande Split-Path retourne uniquement la partie spécifiée d'un chemin d'accès, telle que le répertoire parent, un répertoire enfant ou un nom de fichier. Vous pouvez utiliser cette applet de commande pour afficher ou envoyer uniquement une partie sélectionnée d'un chemin d'accès dans un script ou une application.
   

PARAMÈTRES
    -path <string[]>
        Spécifie les chemins d'accès à fractionner. Les caractères génériques sont autorisés. Si le chemin d'accès inclut des espaces, mettez-le entre guillemets.
       
    -qualifier <SwitchParameter>
        Retourne uniquement le qualificateur du chemin d'accès spécifié. Pour les fournisseurs FileSystem et Registry, le qualificateur est le lecteur du chemin d'accès du fournisseur, comme C: ou HKCU:.
       
    -parent <SwitchParameter>
        Retourne uniquement les conteneurs parents de l'élément ou du conteneur spécifié par le chemin d'accès. Par exemple, dans le chemin d'accès " C:\Test\Logs\Pass1.log ", la commande retourne " C:\Test\Logs ". Parent est le paramètre d'emplacement de fractionnement par défaut.
       
    -leaf <SwitchParameter>
        Retourne uniquement le dernier élément ou conteneur dans le chemin d'accès. Par exemple, dans le chemin d'accès " C:\Test\Logs\Pass1.log ", la commande retourne uniquement " Pass1.log ".
       
    -noQualifier <SwitchParameter>
        Renvoie le chemin d'accès sans le qualificateur. Pour les fournisseurs FileSystem et Registry, le qualificateur est le lecteur du chemin d'accès du fournisseur, comme C: ou HKCU:. Par exemple, dans le chemin d'accès " C:\Test\Logs\Pass1.log ", la commande retourne uniquement " \Test\Logs\Pass1.log ".
       
    -isAbsolute <SwitchParameter>
        Retourne TRUE s'il s'agit d'un chemin d'accès absolu et FAUX en présence d'un chemin d'accès relatif. Un chemin d'accès absolu a une longueur supérieure à zéro et il n'utilise pas de point (.) pour indiquer le chemin d'accès actuel.
       
    -resolve <SwitchParameter>
        Affiche les éléments référencés par le chemin d'accès demeurant après le fractionnement.
       
    -credential <PSCredential>
        Utilise des informations d'identification pour valider l'accès à la ressource. <Credential> représente un nom d'utilisateur, tel que " Utilisateur01 " ou " Domaine01\Utilisateur01 ", ou un objet PSCredential, tel que celui récupéré à l'aide de l'applet de commande Get-Credential. Si vous tapez un nom d'utilisateur, vous êtes invité à entrer un mot de passe. Ce paramètre s'affiche, mais il n'est pas pris en charge par les applets de commande principales et les fournisseurs de Windows PowerShell.
       
    -literalPath <string[]>
        Spécifie les chemins d'accès à fractionner. Contrairement à Path, la valeur de LiteralPath est utilisée exactement telle que vous la tapez. Aucun caractère n'est interprété en tant que caractère générique. Si le chemin d'accès inclut des caractères d'échappement, mettez-le entre des guillemets simples. Les guillemets simples indiquent à Windows PowerShell qu'aucun caractère ne doit être interprété en tant que séquence d'échappement.
       
    <CommonParameters>
        Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug,
        -ErrorAction, -ErrorVariable et -OutVariable. Pour plus d'informations,
        tapez « get-help about_commonparameters ».
   
    -------------------------- EXEMPLE 1 --------------------------
   
    C:\PS>split-path "HKCU:\Software\Microsoft" -qualifier
   
    Cette commande retourne uniquement le qualificateur (le lecteur) du chemin d'accès.
   
   
    HKCU:
   
    -------------------------- EXEMPLE 2 --------------------------
   
    C:\PS>split-path "C:\Test\Logs\*.log" -leaf -resolve
   
    Cette commande affiche les fichiers référencés par le chemin d'accès fractionné. Dans la mesure où ce chemin d'accès est fractionné au niveau du dernier élément (le nœud terminal), seuls les noms de fichier des chemins d'accès sont affichés.
   
   
    Pass1.log
    Pass2.log
    ...
   
    -------------------------- EXEMPLE 3 --------------------------
   
    C:\PS>split-path "C:\WINDOWS\system32\WindowsPowerShell\V1.0\about_*.txt"
   
    Cette commande retourne uniquement les conteneurs parents du chemin d'accès. Split-Path n'inclut pas de paramètres de fractionnement et, par conséquent, elle utilise l'emplacement de fractionnement par défaut, à savoir Parent.
   
   
    C:\WINDOWS\system32\WindowsPowerShell
   
    -------------------------- EXEMPLE 4 --------------------------
   
    C:\PS>split-path ".\My Pictures\*.jpg"
   
    Cette commande détermine si le chemin d'accès est relatif ou absolu. Dans cet exemple, le chemin d'accès est relatif au répertoire actif, représenté par un point (.) et elle retourne donc FALSE ($false).
   
   
    False
   
    -------------------------- EXEMPLE 5 --------------------------
   
    C:\PS>cd (split-path $profile)
   
    Cette commande bascule vers le répertoire contenant le profil Windows PowerShell. " CD " est un alias de l'applet de commande Set-Location qui change le répertoire actif. La commande entre parenthèses utilise l'applet de commande Split-Path pour retourner uniquement le parent du chemin d'accès stocké dans la variable $Profile intégrée. (Le paramètre Parent est le paramètre d'emplacement de fractionnement par défaut et, par conséquent, il peut être omis de la commande.) Les parenthèses imposent à Windows PowerShell d'exécuter la commande en premier. Cette méthode permet d'atteindre aisément un répertoire doté d'un long nom de chemin d'accès.
   
   
    PS C:\Documents and Settings\NicoleH\My Documents\PSConfiguration>
   
REMARQUES
    Pour plus d'informations, tapez : "get-help Split-Path -detailed".
    Pour obtenir des informations techniques, tapez : "get-help Split-Path -full".



NOM
    Test-Path
   
RÉSUMÉ
    Détermine si tous les éléments d'un chemin d'accès existent.
   
   
SYNTAXE
    Test-Path [-path] <string[]> [-pathType {<Any> | <Container> | <Leaf>}] [-isValid] [-include <string[]>] [-exclude <string[]>] [-filter <string>] [-credential <PSCredential>] [<CommonParameters>]
   
    Test-Path [-literalPath] <string[]> [-pathType {<Any> | <Container> | <Leaf>}] [-isValid] [-include <string[]>] [-exclude <string[]>] [-filter <string>] [-credential <PSCredential>] [<CommonParameters>]
   
   
DESCRIPTION DÉTAILLÉE
    L'applet de commande Test-Path détermine si tous les éléments du chemin d'accès existent. Elle retourne " true " ($true) si tous les éléments existent et " false " ($false) dans le cas contraire.
   

PARAMÈTRES
    -path <string[]>
        Spécifie un chemin d'accès à vérifier. Les caractères génériques sont autorisés. Si le chemin d'accès inclut des espaces, mettez-le entre guillemets. Le nom de paramètre (" -Path ") est facultatif.
       
    -pathType <TestPathType>
        Détermine le type d'élément contenu dans le chemin d'accès. Retourne TRUE si l'élément est du type spécifié et FALSE dans le cas contraire.
       
        Les valeurs valides sont les suivantes :
        -- Container (Conteneur) : un élément qui contient d'autres éléments, tel qu'un répertoire ou une clé de Registre.
       
        -- Leaf (Nœud terminal) : un élément qui ne contient pas d'autres éléments, tel qu'un fichier ou une entrée de Registre.
       
        -- Any (Indifférent) : l'un ou l'autre des éléments ci-dessus.
        Les valeurs acceptées pour ce paramètre sont les suivantes :
       
    -isValid <SwitchParameter>
        Détermine si la syntaxe du chemin d'accès est correcte, que les éléments du chemin d'accès existent ou pas. Retourne TRUE si la syntaxe de chemin d'accès est valide et FALSE dans le cas contraire.
       
    -include <string[]>
        Vérifie uniquement les chemins d'accès spécifiés. La valeur de ce paramètre qualifie le paramètre Path. Entrez un élément ou un modèle de chemin d'accès, tel que " *.txt ". Les caractères génériques sont autorisés.
       
    -exclude <string[]>
        Omet les éléments spécifiés. La valeur de ce paramètre qualifie le paramètre Path. Entrez un élément ou un modèle de chemin d'accès, tel que " *.txt ". Les caractères génériques sont autorisés.
       
    -filter <string>
        Spécifie un filtre dans le format ou le langage du fournisseur. La valeur de ce paramètre qualifie le paramètre Path. La syntaxe du filtre, notamment l'utilisation de caractères génériques, dépend du fournisseur. Les filtres sont plus efficaces que les autres paramètres, car le fournisseur les applique lors de la récupération des objets, plutôt que de laisser le soin à Windows PowerShell de filtrer les objets une fois qu'ils ont été récupérés.
       
    -credential <PSCredential>
        Utilise des informations d'identification pour valider l'accès à la ressource. <Credential> représente un nom d'utilisateur, tel que " Utilisateur01 " ou " Domaine01\Utilisateur01 ", ou un objet PSCredential, tel que celui récupéré à l'aide de l'applet de commande Get-Credential. Si vous tapez un nom d'utilisateur, vous êtes invité à entrer un mot de passe. Ce paramètre s'affiche, mais il n'est pas pris en charge par les applets de commande principales et les fournisseurs de Windows PowerShell.
       
    -literalPath <string[]>
        Spécifie un chemin d'accès à vérifier. Contrairement à Path, la valeur de LiteralPath est utilisée exactement telle que vous la tapez. Aucun caractère n'est interprété en tant que caractère générique. Si le chemin d'accès inclut des caractères d'échappement, mettez-le entre des guillemets simples. Les guillemets simples indiquent à Windows PowerShell qu'aucun caractère ne doit être interprété en tant que séquence d'échappement.
       
    <CommonParameters>
        Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug,
        -ErrorAction, -ErrorVariable et -OutVariable. Pour plus d'informations,
        tapez « get-help about_commonparameters ».
   
    -------------------------- EXEMPLE 1 --------------------------
   
    C:\PS>test-path "C:\Documents and Settings\NicoleH
   
    Cette commande détermine si tous les éléments du chemin d'accès existent.
   
   
   
   
    -------------------------- EXEMPLE 2 --------------------------
   
    C:\PS>test-path $PROFILE
   
    C:\PS>test-path $PROFILE -IsValid
   
    Ces commandes vérifient le chemin d'accès au profil Windows PowerShell. La première commande détermine si tous les éléments du chemin d'accès existent. La deuxième commande détermine si la syntaxe du chemin d'accès est correcte. Dans ce cas, le chemin d'accès est incorrect (FALSE), mais la syntaxe est correcte (TRUE). Ces commandes utilisent $PROFILE, la variable intégrée qui pointe vers l'emplacement du profil et ce, même lorsque aucun profil n'existe.
   
   
   
   
    -------------------------- EXEMPLE 3 --------------------------
   
    C:\PS>test-path C:\CAD\Commercial_buildings\* -exclude *.dwg
   
    Cette commande détermine si le répertoire Commercial Buildings contient des fichiers autres que des fichiers .dwg.
   
   
   
   
    -------------------------- EXEMPLE 4 --------------------------
   
    C:\PS>test-path $profile -pathtype leaf
   
    Cette commande détermine si le chemin d'accès stocké dans la variable $profile mène à un répertoire ou à un fichier.
   
   
   
   
REMARQUES
    Pour plus d'informations, tapez : "get-help Test-Path -detailed".
    Pour obtenir des informations techniques, tapez : "get-help Test-Path -full".






 

Dernière mise à jour : ( 12-12-2006 )
 
© 2017 PowerShell-Scripting.com