Convert-Path

  • Riferimento
Modulo:
Microsoft.PowerShell.Management

Converte un percorso da un percorso di PowerShell a un percorso del provider di PowerShell.

Sintassi

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

Descrizione

Il Convert-Path cmdlet converte un percorso da un percorso di PowerShell a un percorso del provider di PowerShell.

Esempio

Esempio 1: Convertire la directory di lavoro in un percorso di file system standard

In questo esempio viene convertita la directory di lavoro corrente, rappresentata da un punto (.) in un percorso FileSystem standard.

PS C:\> Convert-Path .
C:\

Esempio 2: Convertire un percorso del provider in un percorso del Registro di sistema standard

Questo esempio converte il percorso del provider PowerShell in un percorso del Registro di sistema standard.

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

Esempio 3: Convertire un percorso in una stringa

In questo esempio il percorso viene convertito nella home directory del provider corrente, ovvero il provider FileSystem, in una stringa.

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

Parametri

-LiteralPath

Specifica, come matrice di stringhe, il percorso da convertire. Il valore del parametro LiteralPath viene usato esattamente come viene tipizzato. Nessun carattere viene interpretato come carattere jolly. Se il percorso include caratteri di escape, racchiuderlo tra virgolette singole. Le virgolette singole indicano a PowerShell di non interpretare alcun carattere come sequenze di escape.

Per altre informazioni, vedere about_Quoting_Rules.

Tipo:String[]
Alias:PSPath
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Path

Specifica il percorso di PowerShell da convertire.

Tipo:String[]
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:True

-UseTransaction

Include il comando nella transazione attiva. Questo parametro è valido solo quando è in corso una transazione. Per altre informazioni, vedere about_transactions.

Tipo:SwitchParameter
Alias:usetx
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

String

È possibile inviare tramite pipe un percorso, ma non un percorso letterale, a questo cmdlet.

Output

String

Questo cmdlet restituisce una stringa contenente il percorso convertito.

Note

Windows PowerShell include gli alias seguenti per Convert-Path:

  • cvpa

I cmdlet che contengono il sostantivo Path modificano i nomi dei percorsi e restituiscono i nomi in un formato conciso che tutti i provider di PowerShell possono interpretare. Sono progettati per l'uso in programmi e script in cui si desidera visualizzare tutto o parte di un percorso in un formato specifico. Usarli come usare Dirname, Normpath, Realpath, Join o altri manipolatori di percorso.

È possibile usare i cmdlet di percorso con diversi provider, inclusi i provider FileSystem, Registry e Certificate .

Questo cmdlet è progettato per lavorare con i dati esposti da qualsiasi provider. Per elencare i provider disponibili nella sessione, digitare Get-PSProvider. Per altre informazioni, vedere about_Providers.

Convert-Path converte solo i percorsi esistenti. Non può essere usato per convertire un percorso che non esiste ancora.