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.






Voir aussi




Table des matières