Convertit un chemin d'accès Windows PowerShell en chemin d'accès à un fournisseur Windows PowerShell.
Syntaxe
Convert-Path [-LiteralPath] <string[]> [-UseTransaction] [<CommonParameters>] Convert-Path [-Path] <string[]> [-UseTransaction] [<CommonParameters>]
Description
L'applet de commande Convert-Path convertit un chemin d'accès Windows PowerShell en chemin d'accès de fournisseur Windows PowerShell.
Paramètres
-LiteralPath <string[]>
Spécifie le chemin d'accès à convertir. La valeur du paramètre LiteralPath est utilisée exactement comme elle est tapé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 à Windows PowerShell qu'aucun caractère ne doit être interprété en tant que séquence d'échappement.
|
Obligatoire ? |
true |
|
Position ? |
1 |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
true (ByPropertyName) |
|
Accepter les caractères génériques ? |
false |
-Path <string[]>
Spécifie le chemin d'accès Windows PowerShell à convertir.
|
Obligatoire ? |
true |
|
Position ? |
1 |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
true (ByValue, ByPropertyName) |
|
Accepter les caractères génériques ? |
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.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.
Entrées et sorties
Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.
|
Entrées |
System.String Vous pouvez diriger un chemin d'accès (mais pas un chemin d'accès littéral) vers Convert-Path. |
|
Sorties |
System.String Convert-Path retourne une chaîne qui contient le chemin d'accès converti. |
Remarques
Les applets de commande contenant le nom Path (les applets de commande Path) manipulent les noms de chemin d'accès et les retournent dans un format concis pouvant être interprété par tous les fournisseurs Windows PowerShell. Elles sont conçues pour être utilisées dans des programmes et des scripts dans lesquels vous voulez afficher l'intégralité ou une partie d'un nom de chemin d'accès dans un format particulier. Utilisez-les comme Dirname, Normpath, Realpath, Join ou tout autre manipulateur de chemin d'accès.
Vous pouvez utiliser les applets de commande Path avec plusieurs fournisseurs, notamment les fournisseurs FileSystem, Registry et Certificate.
L'applet de commande Convert-Path est conçue pour utiliser 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.
Exemple 1
C:\PS>convert-path ~ Description ----------- Cette commande développe le répertoire de travail actif.
Exemple 2
C:\PS>convert-path HKLM:\software\microsoft Description ----------- Cette commande convertit le chemin d'accès au fournisseur Windows PowerShell en chemin d'accès standard au Registre.
Voir aussi