Condividi tramite

Join-Path

  • Riferimento
Modulo:
Microsoft.PowerShell.Management

Combina un percorso e un percorso figlio in un unico percorso.

Sintassi

Join-Path
    [-Path] <String[]>
    [-ChildPath] <String>
    [-Resolve]
    [-Credential <PSCredential>]
    [-UseTransaction]
    [<CommonParameters>]

Descrizione

Il cmdlet Join-Path combina un percorso e un percorso figlio in un unico percorso. Il provider fornisce i delimitatori di percorso.

Esempio

Esempio 1: Combinare un percorso con un percorso figlio

Join-Path -Path "path" -ChildPath "childpath"

path\childpath

Questo comando usa Join-Path per combinare un percorso con un percorso figlio.

Poiché il comando viene eseguito dal provider FileSystem, fornisce il delimitatore \ per unire i percorsi.

Esempio 2: Combinare percorsi che contengono già separatori di directory

Join-Path -Path "path\" -ChildPath "\childpath"

path\childpath

I separatori di directory esistenti \ vengono gestiti in modo che sia presente un solo separatore tra percorso e ChildPath.

Esempio 3: Visualizzare file e cartelle unendo un percorso a un percorso figlio

Join-Path "C:\win*" "System*" -Resolve

Questo comando visualizza i file e le cartelle a cui viene fatto riferimento unendo il percorso C:\Win\* e il percorso figlio System\*. Visualizza gli stessi file e cartelle di Get-ChildItem, ma visualizza il percorso completo di ogni elemento. In questo comando vengono omessi i Path e ChildPath nomi di parametri facoltativi.

Esempio 4: Usare Join-Path con il provider del Registro di sistema di PowerShell

PS HKLM:\> Join-Path -Path System -ChildPath *ControlSet* -Resolve

HKLM:\System\ControlSet001
HKLM:\System\CurrentControlSet

Questo comando visualizza le chiavi del Registro di sistema nella sottochiave del Registro di sistema HKLM\System che includono ControlSet.

Il parametro resolve tenta di risolvere il percorso unito, inclusi i caratteri jolly dal percorso del provider corrente HKLM:\

Esempio 5: Combinare più radici di percorso con un percorso figlio

Join-Path -Path C:, D:, E:, F: -ChildPath New

C:\New
D:\New
E:\New
F:\New

Questo comando usa Join-Path per combinare più radici di percorso con un percorso figlio.

Nota

Le unità specificate da Percorso devono esistere o il join di tale voce avrà esito negativo.

Esempio 6: Combinare le radici di un'unità del file system con un percorso figlio

Get-PSDrive -PSProvider FileSystem |
    ForEach-Object {$_.Root} |
    Join-Path -ChildPath "Subdir"

C:\Subdir
D:\Subdir

Questo comando combina le radici di ogni unità del file system di PowerShell nella console con il percorso figlio Subdir.

Il comando usa il cmdlet Get-PSDrive per ottenere le unità di PowerShell supportate dal provider FileSystem. L'istruzione ForEach-Object seleziona solo la proprietà radice degli oggetti PSDriveInfo e la combina con il percorso figlio specificato.

L'output mostra che le unità di PowerShell nel computer includono un'unità mappata alla directory C:\Program Files.

Parametri

-ChildPath

Specifica gli elementi da aggiungere al valore del parametro Path. Sono consentiti caratteri jolly. Il parametro ChildPath è obbligatorio, anche se il nome del parametro ("ChildPath") è facoltativo.

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

-Credential

Nota

Questo parametro non è supportato da alcun provider installato con PowerShell. Per rappresentare un altro utente o elevare le credenziali quando si esegue questo cmdlet, usare Invoke-Command.

Tipo:PSCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Path

Specifica il percorso principale (o i percorsi) a cui viene aggiunto il percorso figlio. Il valore di Path determina il provider che unisce i percorsi e aggiunge i delimitatori di percorso. Sono consentiti caratteri jolly.

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

-Resolve

Indica che questo cmdlet deve tentare di risolvere il percorso aggiunto dal provider corrente.

  • Se si usano caratteri jolly, il cmdlet restituisce tutti i percorsi che corrispondono al percorso unito.
  • Se non si usano caratteri jolly, il cmdlet restituisce un errore se il percorso non esiste.
Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-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 una stringa contenente un percorso a questo cmdlet.

Output

String

Questo cmdlet restituisce una stringa contenente il percorso risultante.

Note

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 essere usati in cui si desidera visualizzare tutto o parte di un percorso in un formato specifico. Usarli come usare Dirname, Normpath, Realpath, Joino altri manipolatori di percorso.

È possibile usare i cmdlet di percorso con diversi provider, inclusi i provider di FileSystem, Registrye 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.