Partager via

Resolve-Path

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

Résout les caractères génériques d’un chemin d’accès et affiche le contenu du chemin.

Syntaxe

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

Description

L’applet de commande Resolve-Path 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 Resolve-Path retourner 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

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

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

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

Cette commande retourne tous les dossiers du dossier C :\Windows. 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.

Exemple 5 : Obtenir des chemins relatifs

PS C:\> 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 lecteur C : .

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 sous-dossier Test[xml]. L’utilisation de LiteralPath entraîne le traitement des crochets comme des caractères normaux plutôt qu’une expression régulière.

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

Paramètres

-Credential

Spécifie un compte d’utilisateur autorisé à effectuer 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 commande Get-Credential. 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é comme des caractères génériques. 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 requis. Vous pouvez également diriger une chaîne de chemin vers Resolve-Path.

Type:String[]
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-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 valide uniquement lorsqu’une transaction est en cours. 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

System.Management.Automation.PathInfo, System.String

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

Notes

  • Les applets de commande *-Path 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.