Resolve-Path
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 [-LiteralPath] <string[]> [-Credential <PSCredential>] [-Relative] [-UseTransaction] [<CommonParameters>]
Resolve-Path [-Path] <string[]> [-Credential <PSCredential>] [-Relative] [-UseTransaction] [<CommonParameters>]
Description
L'applet de commande Resolve-Path interprète les caractères génériques figurant dans un chemin d'accès et affiche les éléments et les conteneurs à l'emplacement spécifié par le chemin d'accès (comme les fichiers et les dossiers ou les clés de Registre et les sous-clés).
Paramètres
-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 |
-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.
Obligatoire ? |
true |
Position ? |
1 |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
true (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-Path <string[]>
Spécifie le chemin d'accès Windows PowerShell à résoudre. Ce paramètre est obligatoire. Vous pouvez aussi diriger une chaîne de chemin d'accès vers Resolve-Path.
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 |
-Relative
Retourne un chemin d'accès relatif.
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 Resolve-Path. |
Sorties |
System.String Resolve-Path retourne une chaîne qui contient le chemin d'accès résolu. |
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 Resolve-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>resolve-path ~
C:\Users\User01
Description
-----------
Cette commande résout le chemin d'accès représenté par le caractère tilde (~), qui correspond au chemin d'accès de base.
Exemple 2
C:\PS>resolve-path windows
C:\Windows
Description
-----------
En cas d'exécution de la racine du lecteur C:, cette commande retourne le chemin d'accès au répertoire Windows dans le lecteur C:.
Exemple 3
C:\PS>"C:\windows\*" | resolve-path
Description
-----------
Cette commande retourne tous les répertoires dans le répertoire C:\Windows. Cette commande utilise un opérateur de pipeline (|) pour envoyer une chaîne de chemin d'accès à Resolve-Path.
Exemple 4
C:\PS>resolve-path \\Server01\public
Description
-----------
Cette commande résout un chemin d'accès UNC (Universal Naming Convention) et retourne les partages dans le chemin d'accès.
Exemple 5
C:\PS>resolve-path c:\prog* -relative
..\Program Files
..\Program Files (x86)
..\programs.txt
Description
-----------
Cette commande retourne des chemins d'accès relatifs aux répertoires situés à la racine du lecteur C:.
Exemple 6
C:\PS>resolve-path -literalPath test[xml]
Description
-----------
Cette commande résout le chemin d'accès au sous-répertoire Test [xml] du répertoire actif. Il utilise le paramètre LiteralPath pour indiquer que les crochets ne sont pas des caractères d'expressions régulières.