Partager via


Resolve-Path

Résout les caractères génériques inclus dans un chemin d'accès et affiche le contenu de ce dernier.

Syntax

Resolve-Path
       [-Path] <String[]>
       [-Relative]
       [-Credential <PSCredential>]
       [<CommonParameters>]
Resolve-Path
       -LiteralPath <String[]>
       [-Relative]
       [-Credential <PSCredential>]
       [<CommonParameters>]

Description

L’applet Resolve-Path de commande affiche les éléments et les conteneurs qui correspondent au modèle générique à l’emplacement spécifié. La correspondance peut inclure des fichiers, des dossiers, des clés de Registre ou tout autre objet accessible à partir d’un fournisseur PSDrive .

Exemples

Exemple 1 : Résoudre le chemin du dossier de base

Le caractère tilde (~) est une notation abrégée pour le dossier d’accueil de l’utilisateur actuel. Cet exemple montre comment Resolve-Path renvoyer la valeur du chemin d’accès complet.

Resolve-Path ~

Path
----
C:\Users\User01

Exemple 2 : Résoudre le chemin d’accès du dossier Windows

Resolve-Path -Path "windows"

Path
----
C:\Windows

Lors de l’exécution à partir de la racine du C: lecteur, cette commande retourne le chemin du Windows dossier dans le C: lecteur.

Exemple 3 : Obtenir tous les chemins d’accès dans le dossier Windows

"C:\windows\*" | Resolve-Path

Cette commande retourne tous les fichiers et dossiers du C:\Windows dossier. La commande utilise un opérateur de pipeline (|) pour envoyer une chaîne de chemin à Resolve-Path.

Exemple 4 : Résoudre un chemin UNC

Resolve-Path -Path "\\Server01\public"

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 : Obtenir des chemins relatifs

Resolve-Path -Path "c:\prog*" -Relative

.\Program Files
.\Program Files (x86)
.\programs.txt

Cette commande retourne des chemins relatifs pour les répertoires à la racine du C: lecteur.

Exemple 6 : Résoudre un chemin contenant des crochets

Cet exemple utilise le paramètre LiteralPath pour résoudre le chemin d’accès du Test[xml] sous-dossier. L’utilisation de LiteralPath permet de traiter les crochets comme des caractères normaux plutôt que comme une expression régulière.

PS C:\> Resolve-Path -LiteralPath 'test[xml]'

Paramètres

-Credential

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, ou passez un objet PSCredential . Vous pouvez créer un objet PSCredential à l’aide de l’applet de Get-Credential commande . Si vous tapez un nom d’utilisateur, cette applet de commande vous invite à entrer un mot de passe.

Ce paramètre n’est pris en charge par aucun fournisseur installé avec PowerShell.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-LiteralPath

Spécifie le chemin d'accès à résoudre. La valeur du paramètre LiteralPath est utilisée exactement comme tapé. Aucun caractère n'est interprété en tant que caractère générique. Si le chemin inclut des caractères d’échappement, placez-le entre guillemets simples ('). Les guillemets simples indiquent à PowerShell de ne pas interpréter de caractères comme des séquences d’échappement.

Type:String[]
Aliases:PSPath, LP
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Path

Spécifie le chemin d’accès PowerShell à résoudre. Ce paramètre est obligatoire. Vous pouvez également diriger une chaîne de chemin vers Resolve-Path. Les caractères génériques sont autorisés.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Relative

Indique que cette applet de commande retourne un chemin relatif.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

String

Vous pouvez diriger une chaîne qui contient un chemin d’accès à cette applet de commande.

Sorties

PathInfo

Par défaut, cette applet de commande retourne un objet PathInfo .

String

Si vous spécifiez le paramètre Relative , cette applet de commande retourne une valeur de chaîne pour le chemin d’accès résolu.

Notes

PowerShell inclut les alias suivants pour Resolve-Path:

  • Toutes les plateformes :
    • rvpa

Les *-Path applets de commande fonctionnent avec les fournisseurs FileSystem, Registry et Certificate .

Resolve-Path est conçu pour fonctionner avec n’importe quel fournisseur. Pour répertorier les fournisseurs disponibles dans votre session, tapez Get-PSProvider. Pour plus d’informations, consultez about_providers.

Resolve-Path résout uniquement les chemins d’accès existants. Il ne peut pas être utilisé pour résoudre un emplacement qui n’existe pas encore.