Resolve-Path

Resolve-Path
    [-Path] <string[]>
    [-Relative]
    [-RelativeBasePath <string>]
    [-Credential <pscredential>]
    [-Force]
    [<CommonParameters>]

Resolve-Path
    -LiteralPath <string[]>
    [-Relative]
    [-RelativeBasePath <string>]
    [-Credential <pscredential>]
    [-Force]
    [<CommonParameters>]

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.

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.

Resolve-Path ~

Path
----
C:\Users\User01

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

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

Cette commande retourne tous les fichiers et 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.

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.

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

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.

Resolve-Path -LiteralPath 'test[xml]'

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 relative, elle retourne une string représentant le chemin d’accès relatif de $Env:TEMP au fichier 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

Par défaut, Resolve-Path ne retourne pas d’éléments masqués. Cet exemple utilise le paramètre force pour résoudre les éléments masqués. La commande Get-Item confirme que le dossier .git est masqué. L’utilisation de Resolve-Path sans le paramètre Force retourne uniquement les éléments visibles. L’ajout du paramètre Force retourne tous les éléments, y compris les éléments masqués.

PS> Get-Item .git -Force

    Directory: D:\Git\PS-Docs\PowerShell-Docs

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
d--h-           9/25/2024  4:46 PM                .git

PS> Resolve-Path .git*

Path
----
D:\Git\PS-Docs\PowerShell-Docs\.github
D:\Git\PS-Docs\PowerShell-Docs\.gitattributes
D:\Git\PS-Docs\PowerShell-Docs\.gitignore

PS> Resolve-Path .git* -Force

Path
----
D:\Git\PS-Docs\PowerShell-Docs\.git
D:\Git\PS-Docs\PowerShell-Docs\.github
D:\Git\PS-Docs\PowerShell-Docs\.gitattributes
D:\Git\PS-Docs\PowerShell-Docs\.gitignore

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.

Vous pouvez acheminer une chaîne contenant un chemin vers cette applet de commande.

Par défaut, cette applet de commande retourne un objet PathInfo.

Si vous spécifiez le paramètre relative, cette applet de commande retourne une valeur de chaîne pour le chemin résolu.

PowerShell inclut les alias suivants pour Resolve-Path:

• Toutes les plateformes :
  • rvpa

Les applets de commande *-Path fonctionnent avec les fournisseurs FileSystem, Registryet 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, voir 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.