Partager via

Convert-Path

Module:
Microsoft.PowerShell.Management Module

Convertit un chemin d’accès à partir d’un chemin Windows PowerShell en chemin d’accès du fournisseur Windows 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 à partir d’un chemin d’accès Windows PowerShell vers un chemin d’accès du fournisseur Windows PowerShell.

Exemples

Exemple 1 : Convertir le répertoire de travail en chemin d’accès standard du système de fichiers

PS C:\> Convert-Path .

Cette commande convertit le répertoire de travail actuel, représenté par un point (.), en chemin d’accès standard du système de fichiers.

Exemple 2 : Convertir un chemin d’accès fournisseur en chemin d’accès de Registre standard

PS C:\> Convert-Path HKLM:\Software\Microsoft

Cette commande convertit le chemin du fournisseur Windows PowerShell en chemin d’accès de Registre standard.

Exemple 3 : Convertir un chemin d’accès en chaîne de caractères

PS C:\> Convert-Path ~
C:\Users\User01

Cette commande convertit le chemin d’accès au répertoire de base du fournisseur actuel, qui est le fournisseur FileSystem, en chaîne.

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 à Windows PowerShell de ne pas interpréter de caractères comme séquences d’échappement.

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 Windows PowerShell à convertir.

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

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

  • 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 Windows 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 nom de 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.