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[]>
[-UseTransaction]
[<CommonParameters>]
LiteralPath
Convert-Path
-LiteralPath <String[]>
[-UseTransaction]
[<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
Paramètres
-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 |
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 |
-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 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
Windows PowerShell inclut les alias suivants pour Convert-Path:
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.
