Share via

Resolve-Path

  • Référence
Module:
Microsoft.PowerShell.Management

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 de base de l’utilisateur actuel. Cet exemple montre comment Resolve-Path renvoyer la valeur de chemin d’accès complet.

PS C:\> Resolve-Path ~

Path
----
C:\Users\User01

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

PS C:\> Resolve-Path -Path "windows"

Path
----
C:\Windows

Lorsqu’elle est exécutée à 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

PS C:\> "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 d’accès à Resolve-Path.

Exemple 4 : Résoudre un chemin UNC

PS C:\> 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 d’accès relatifs

PS C:\> Resolve-Path -Path "c:\prog*" -Relative

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

Cette commande retourne des chemins d’accès 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 du Test[xml] sous-dossier. L’utilisation de LiteralPath entraîne le traitement des 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, par User01 exemple 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 typé. Aucun caractère n'est interprété en tant que caractère générique. Si le chemin d’accès comprend 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 d’accès 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 vers cette applet de commande.

Sorties

System.Management.Automation.PathInfo, System.String

Renvoie un objet PathInfo . Retourne une valeur de chaîne pour le chemin d’accès résolu si vous spécifiez le paramètre Relative .

Notes

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.