Condividi tramite

Join-Path

Modulo:
Microsoft.PowerShell.Management Module

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

Sintassi

Default (Impostazione predefinita) 

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

Descrizione

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

Esempio

Esempio 1: Combinare un percorso con un percorso figlio

PS C:\> 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 di FileSystem, fornisce il delimitatore \ per unire i percorsi.

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

PS C:\> Join-Path -Path "path\" -ChildPath "\childpath"

path\childpath

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

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

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

Questo comando consente di visualizzare i file e le cartelle a cui si fa 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 nomi dei parametri facoltativi Path e ChildPath.

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 congiunto, includendo i caratteri jolly dal percorso del provider corrente HKLM:\

Esempio 5: Unire 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.

Annotazioni

Le unità specificate da Path devono esistere o l'unione di quell'elemento fallirà.

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 PSDriveInfo proprietà Root degli oggetti e la combina con il percorso figlio specificato.

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

Parametri

-ChildPath

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:True
DontShow:False

Set di parametri

(All)
Posizione:1
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Credential

Annotazioni

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.

Proprietà dei parametri

Tipo:PSCredential
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Path

Specifica il percorso principale (o i percorsi) a cui viene aggiunto il percorso figlio. Sono consentiti i metacaratteri.

Il valore di Path determina il provider che unisce i percorsi e aggiunge i delimitatori di percorso. Il parametro Path è obbligatorio, anche se il nome del parametro ("Path") è facoltativo.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:True
DontShow:False
Alias:PSPath

Set di parametri

(All)
Posizione:0
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Resolve

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

  • Se vengono utilizzati caratteri jolly, il comando cmdlet restituisce tutti i percorsi che corrispondono al percorso unito.
  • Se i caratteri jolly non vengono utilizzati, il cmdlet genererà un errore se il percorso non esiste.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-UseTransaction

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:usetx

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

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 (i cmdlet 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 nome di percorso in un formato specifico. Usali come useresti Dirname, Normpath, Realpath, Join o 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, consultare about_Providers.