Partager 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.

Syntaxe

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

Description

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

Exemples

Exemple 1 : Résoudre le chemin du dossier d’accueil

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 retourner la valeur de 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 d’accès 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 d’accès à 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 entraîne le traitement des crochets comme des caractères normaux plutôt qu’une expression régulière.

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 pas pris en charge par les fournisseurs installés avec PowerShell.

Type:PSCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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 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 séquences d’échappement.

Type:String[]
Alias:PSPath
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:True

-Relative

Indique que cette applet de commande retourne un chemin relatif.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
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 uniquement valide au cours d’une transaction. Pour plus d’informations, consultez about_transactions.

Type:SwitchParameter
Alias:usetx
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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 résolu.

Notes

Windows PowerShell inclut les alias suivants pour Resolve-Path:

  • 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 existants. Il ne peut pas être utilisé pour résoudre un emplacement qui n’existe pas encore.