Join-Path
Combina un percorso e un percorso figlio in un singolo percorso.
Sintassi
Join-Path
[-Path] <String[]>
[-ChildPath] <String>
[-Resolve]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
Descrizione
Il Join-Path
cmdlet combina un percorso e un percorso figlio in un singolo 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 per combinare Join-Path
un percorso con un percorso figlio.
Poiché il comando viene eseguito dal FileSystem
provider, fornisce il \
delimitatore per aggiungere i percorsi.
Esempio 2: Combinare i percorsi che contengono già separatori di directory
PS C:\> Join-Path -Path "path\" -ChildPath "\childpath"
path\childpath
Separatori \
di directory esistenti e gestiti in modo che sia presente un solo separatore tra Path
e ChildPath
Esempio 3: Visualizzare file e cartelle aggiungendo un percorso con un percorso figlio
Join-Path "C:\win*" "System*" -Resolve
Questo comando visualizza i file e le cartelle a cui si fa riferimento aggiungendo 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
nomi dei parametri facoltativi 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 HKLM\System
Registro di sistema che includono ControlSet
.
Il Resolve
parametro tenta di risolvere il percorso aggiunto, inclusi i caratteri jolly dal percorso del provider corrente HKLM:\
Esempio 5: Combinare più radici del 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 per combinare Join-Path
più radici del percorso con un percorso figlio.
Nota
Le unità specificate da Path
devono esistere o il join di tale voce avrà esito negativo.
Esempio 6: Combinare le radici di un'unità 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à file system di PowerShell nella console con il percorso figlio Subdir.
Il comando usa il Get-PSDrive
cmdlet per ottenere le unità di PowerShell supportate dal provider FileSystem.
L'istruzione ForEach-Object
seleziona solo la proprietà Root degli PSDriveInfo
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 Path
parametro.
I caratteri jolly sono consentiti.
Il ChildPath
parametro è obbligatorio, anche se il nome del parametro ("ChildPath") è facoltativo.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Credential
Nota
Questo parametro non è supportato da alcun provider installato con PowerShell. Per rappresentare un altro utente o elevare le credenziali durante l'esecuzione di questo cmdlet, usare Invoke-Command.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Path
Specifica il percorso principale (o percorsi) a cui viene aggiunto il percorso figlio. I caratteri jolly sono consentiti.
Il valore di Path
determina quale provider aggiunge i percorsi e aggiunge i delimitatori di percorso.
Il Path
parametro è obbligatorio, anche se il nome del parametro ("Path") è facoltativo.
Type: | String[] |
Aliases: | PSPath |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Resolve
Indica che questo cmdlet deve tentare di risolvere il percorso aggiunto dal provider corrente.
- Se vengono usati caratteri jolly, il cmdlet restituisce tutti i percorsi corrispondenti al percorso aggiunto.
- Se non vengono usati caratteri jolly, il cmdlet errorerà se il percorso non esiste.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseTransaction
Include il comando nella transazione attiva. Questo parametro è valido solo quando è in corso una transazione. Per altre informazioni, vedere about_Transactions.
Type: | SwitchParameter |
Aliases: | usetx |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
È possibile inviare una pipe a una stringa contenente un percorso per questo cmdlet.
Output
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 vuole visualizzare tutto o parte di un nome di percorso in un determinato formato. Usarli allo stesso modo di Dirname, Normpath, Realpath, Join o altri modificatori di percorso.
È possibile usare i cmdlet di percorso con diversi provider, inclusi i FileSystem
provider , Registry
e Certificate
.
Questo cmdlet è progettato per usare i dati esposti da qualsiasi provider.
Per elencare i provider disponibili nella sessione, digitare Get-PSProvider
.
Per altre informazioni, vedere about_Providers.