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]
       [-RelativeBasePath <string>]
       [-Credential <pscredential>]
       [<CommonParameters>]
Resolve-Path
       -LiteralPath <string[]>
       [-Relative]
       [-RelativeBasePath <string>]
       [-Credential <pscredential>]
       [<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]'

Exemple 7 : Résoudre un chemin d’accès par rapport à un autre dossier

Cet exemple utilise le paramètre RelativeBasePath pour résoudre le chemin d’accès de l’exécutable pwsh par rapport à $env:TEMP. Lorsque la commande inclut le paramètre de commutateur relatif , elle retourne une chaîne représentant le chemin relatif de $env:TEMP l’exécutable pwsh .

$ExecutablePath = Get-Command -Name pwsh | Select-Object -ExpandProperty Source
Resolve-Path -Path $ExecutablePath -RelativeBasePath $env:TEMP -Relative

..\..\..\..\..\Program Files\PowerShell\7\pwsh.exe

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, LP
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:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RelativeBasePath

Spécifie un chemin d’accès à partir duquel résoudre le chemin relatif. Lorsque vous utilisez ce paramètre, l’applet de commande retourne l’objet System.Management.Automation.PathInfo pour le chemin résolu.

Lorsque vous utilisez ce paramètre avec le paramètre Relative switch, l’applet de commande retourne une chaîne représentant le chemin relatif de RelativeBasePath vers Path.

Ce paramètre a été ajouté dans PowerShell 7.4.

Type:String
Position:Named
Valeur par défaut:None
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

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