Resolve-Path
Résout les caractères génériques d’un chemin d’accès et affiche le contenu du chemin.
Syntaxe
Path (Par défaut)
Resolve-Path
[-Path] <String[]>
[-Relative]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
LiteralPath
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.
Propriétés du paramètre
| Type: | PSCredential |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | 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 inclut des caractères d’échappement, mettez-le entre des guillemets simples. Les guillemets simples indiquent à PowerShell de ne pas interpréter de caractères comme séquences d’échappement.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | PSPath |
Jeux de paramètres
LiteralPath
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Path
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-Relative
Indique que cette applet de commande retourne un chemin relatif.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | usetx |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
Entrées
String
Vous pouvez acheminer une chaîne contenant 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 résolu si vous spécifiez le paramètre relative.
Notes
- Les applets de commande
*-Pathfonctionnent avec les fournisseurs FileSystem, Registry et Certificate. -
Resolve-Pathest conçu pour fonctionner avec n’importe quel fournisseur. Pour répertorier les fournisseurs disponibles dans votre session, tapezGet-PSProvider. Pour plus d’informations, consultez about_providers.