Convert-Path
Convertit un chemin d’accès d’un chemin PowerShell en chemin d’accès du fournisseur PowerShell.
Syntaxe
Path (Par défaut)
Convert-Path
[-Path] <String[]>
[<CommonParameters>]
LiteralPath
Convert-Path
-LiteralPath <String[]>
[<CommonParameters>]
Description
L’applet de commande Convert-Path convertit un chemin d’accès d’un chemin PowerShell en chemin d’accès du fournisseur PowerShell.
Exemples
Exemple 1 : Convertir le répertoire de travail en chemin d’accès standard du système de fichiers
Cet exemple convertit le répertoire de travail actuel, représenté par un point (.), en chemin d’accès FileSystem standard.
PS C:\> Convert-Path .
C:\
Exemple 2 : Convertir un chemin d’accès fournisseur en chemin d’accès de Registre standard
Cet exemple convertit le chemin du fournisseur PowerShell en chemin d’accès de Registre standard.
PS C:\> Convert-Path HKLM:\Software\Microsoft
HKEY_LOCAL_MACHINE\Software\Microsoft
Exemple 3 : Convertir un chemin d’accès en chaîne de caractères
Cet exemple convertit le chemin d’accès au répertoire de base du fournisseur actuel, qui est le fournisseur FileSystem, en chaîne.
PS C:\> Convert-Path ~
C:\Users\User01
Exemple 4 : convertir les chemins d'accès pour les éléments cachés
Par défaut, Convert-Path ne retourne pas d’éléments masqués. Cet exemple utilise le paramètre Force pour trouver des éléments cachés. La commande Get-Item confirme que le dossier .git est masqué. L’utilisation de Convert-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> Convert-Path .git*
D:\Git\PS-Docs\PowerShell-Docs\.github
D:\Git\PS-Docs\PowerShell-Docs\.gitattributes
D:\Git\PS-Docs\PowerShell-Docs\.gitignore
PS> Convert-Path .git* -Force
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
Paramètres
-Force
Permet à l’applet de commande d’obtenir des éléments qui ne peuvent pas être accessibles par l’utilisateur, tels que les fichiers masqués ou système. Le paramètre Force ne contourne pas les restrictions de sécurité. L’implémentation varie entre les fournisseurs. Pour plus d’informations, voir about_Providers.
Ce paramètre a été ajouté dans PowerShell 7.5-preview.5.
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 |
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 |
-LiteralPath
Spécifie, en tant que tableau de chaînes, le chemin à convertir. La valeur du paramètre LiteralPath est utilisée exactement comme il est 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.
Pour plus d'informations, consultez la section sur les règles de citation.
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, DP |
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 à convertir.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | True |
| DontShow: | False |
Jeux de paramètres
Path
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| 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 diriger un chemin d’accès, mais pas un chemin littéral, vers cette applet de commande.
Sorties
String
Cette applet de commande retourne une chaîne qui contient le chemin d’accès converti.
Notes
PowerShell inclut les alias suivants pour Convert-Path:
- Toutes les plateformes :
cvpa
Les applets de commande qui contiennent le nom path manipulent les noms de chemin et retournent les noms dans un format concis que tous les fournisseurs PowerShell peuvent interpréter. Ils sont conçus pour être utilisés dans les programmes et les scripts dans lesquels vous souhaitez afficher tout ou partie d’un chemin d’accès dans un format particulier. Utilisez-les comme Dirname, Normpath, Realpath, Joinou d'autres manipulateurs de chemins le feraient.
Vous pouvez utiliser les cmdlets de chemin d'accès avec plusieurs fournisseurs, notamment les fournisseurs FileSystem, Registry et Certificate.
Cette applet de commande est conçue pour fonctionner avec les données exposées par n’importe quel fournisseur. Pour répertorier les fournisseurs disponibles dans votre session, tapez Get-PSProvider. Pour plus d’informations, voir about_Providers.
Convert-Path convertit uniquement les chemins existants. Il ne peut pas être utilisé pour convertir un emplacement qui n’existe pas encore.
