Partager via

Convert-Path

  • Référence
Module:
Microsoft.PowerShell.Management

Convertit un chemin d’accès d’un chemin PowerShell en chemin d’accès du fournisseur PowerShell.

Syntaxe

Convert-Path
       [-Path] <String[]>
       [-UseTransaction]
       [<CommonParameters>]
Convert-Path
       -LiteralPath <String[]>
       [-UseTransaction]
       [<CommonParameters>]

Description

L’applet Convert-Path de commande convertit un chemin d’accès à partir 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

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 d’accès à convertir. La valeur du paramètre LiteralPath est utilisée exactement comme elle est typée. 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 about_Quoting_Rules.

Type:String[]
Alias:PSPath
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 à convertir.

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

-UseTransaction

Inclut la commande dans la transaction active. Ce paramètre est uniquement valide au cours d’une transaction. Pour plus d’informations, consultez about_transactions.

Type:SwitchParameter
Alias:usetx
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

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 vous le feriez avec Dirname, Normpath, Realpath, Join ou d’autres manipulateurs de chemin d’accès.

Vous pouvez utiliser les applets de commande 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, consultez about_Providers.

Convert-Path convertit uniquement les chemins existants. Il ne peut pas être utilisé pour convertir un emplacement qui n’existe pas encore.