Combina un percorso e un percorso figlio in un unico percorso. I delimitatori del percorso sono forniti dal provider.
Sintassi
Join-Path [-Path] <string[]> [-ChildPath] <string> [-Credential <PSCredential>] [-Resolve] [-UseTransaction] [<CommonParameters>]
Descrizione
Il cmdlet Join-Path combina un percorso e un percorso figlio in un unico percorso. I delimitatori del percorso sono forniti dal provider.
Parametri
-ChildPath <string>
Specifica gli elementi da aggiungere al valore di Path. È consentito l'utilizzo di caratteri jolly. Il parametro ChildPath è obbligatorio, sebbene il nome del parametro ("ChildPath") sia facoltativo.
|
Obbligatorio? |
true |
|
Posizione? |
2 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-Credential <PSCredential>
Specifica un account utente con autorizzazione per l'esecuzione di questa azione. Il valore predefinito è l'utente corrente.
Digitare un nome utente, ad esempio "Utente01" o "Dominio01\Utente01". In alternativa, immettere un oggetto PSCredential, ad esempio quello generato dal cmdlet Get-Credential. Se si digita un nome utente, viene richiesta una password.
Questo parametro non è supportato dai provider installati con Windows PowerShell.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-Path <string[]>
Specifica il percorso o i percorsi principali ai quali viene aggiunto il percorso figlio. È consentito l'utilizzo di caratteri jolly.
Il valore di Path determina quale provider unisce i percorsi e aggiunge i delimitatori. Questo parametro è obbligatorio, sebbene il nome del parametro ("Path") sia facoltativo.
|
Obbligatorio? |
true |
|
Posizione? |
1 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByValue, ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-Resolve
Visualizza gli elementi a cui fa riferimento il percorso unito.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-UseTransaction
Include il comando nella transazione attiva. Questo parametro è valido solo quando è in corso una transazione. Per ulteriori informazioni, vedere about_Transactions.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
<CommonParameters>
Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.
Input e output
Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.
|
Input |
System.String È possibile reindirizzare una stringa che contiene un percorso a Join-Path. |
|
Output |
System.String Join-Path restituisce una stringa che contiene il percorso risultante. |
Note
I cmdlet che contengono il sostantivo Path (cmdlet Path) modificano i nomi dei percorsi e restituiscono i nomi in un formato conciso che può essere interpretato da tutti i provider di Windows PowerShell. Sono progettati per essere utilizzati in programmi e script in cui si intende visualizzare un nome di percorso, completo o parziale, in un determinato formato. Utilizzare questi cmdlet in modo analogo a Dirname, Normpath, Realpath, Join o altri modificatori di percorso.
È possibile utilizzare i cmdlet path con diversi provider, inclusi FileSystem, Registry e Certificate.
Il cmdlet Join-Path è progettato per l'utilizzo di dati esposti da qualsiasi provider. Per elencare i provider disponibili nella sessione, digitare "Get-PSProvider". Per ulteriori informazioni, vedere about_Providers.
Esempio 1
C:\PS>join-path -path c:\win* -childpath System* Descrizione ----------- Con questo comando viene utilizzato Join-Path per combinare il percorso "c:\Win*" con il percorso figlio "System*". Il provider FileSystem di Windows PowerShell unisce il percorso e aggiunge il delimitatore "\".
Esempio 2
C:\PS>join-path c:\win* System* -resolve Descrizione ----------- Con questo comando vengono visualizzati i file e le cartella a cui si fa riferimento unendo il percorso "c:\Win*" e il percorso figlio "System*". Vengono visualizzati gli stessi file e le stesse cartelle ottenute con Get-ChildItem, ma viene visualizzato il percorso completo di ogni elemento. In questo comando, i nomi dei parametri facoltativi Path e ChildPath vengono omessi.
Esempio 3
C:\PS>PS HKLM:\> join-path System *ControlSet* -resolve Descrizione ----------- Con questo comando vengono visualizzate le chiavi del Registro di sistema nella sottochiave del Registro di sistema HKLM\System che include "ControlSet". In questo esempio viene illustrato come utilizzare Join-Path con il provider Registry di Windows PowerShell.
Esempio 4
C:\PS>join-path -path C:, D:, E:, F: -childpath New Descrizione ----------- Questo comando utilizza Join-Path per combinare più radici di percorso a un percorso figlio.
Esempio 5
C:\PS>get-psdrive -psprovider filesystem | foreach {$_.root} | join-path -childpath Subdir
Descrizione
-----------
Questo comando combina le radici di ogni unità del file system di Windows PowerShell nella console al percorso figlio Subdir.
Viene utilizzato il cmdlet Get-PSDrive per ottenere le unità di Windows PowerShell supportate dal provider FileSystem. Mediante l'istruzione ForEach viene selezionata solo la proprietà Root degli oggetti PSDriveInfo, la quale viene combinata con il percorso figlio specificato.
Dall'output si rileva che le unità di Windows PowerShell del computer hanno incluso un'unità mappata alla directory C:\Programmi.
Vedere anche