Restituisce la parte specificata di un percorso.
Sintassi
Split-Path [-IsAbsolute] [-Path] <string[]> [-Credential <PSCredential>] [-LiteralPath <string[]>] [-Resolve] [-UseTransaction] [<CommonParameters>] Split-Path [-Leaf] [-Path] <string[]> [-Credential <PSCredential>] [-LiteralPath <string[]>] [-Resolve] [-UseTransaction] [<CommonParameters>] Split-Path [-NoQualifier] [-Path] <string[]> [-Credential <PSCredential>] [-LiteralPath <string[]>] [-Resolve] [-UseTransaction] [<CommonParameters>] Split-Path [-Parent] [-Path] <string[]> [-Credential <PSCredential>] [-LiteralPath <string[]>] [-Resolve] [-UseTransaction] [<CommonParameters>] Split-Path [-Qualifier] [-Path] <string[]> [-Credential <PSCredential>] [-LiteralPath <string[]>] [-Resolve] [-UseTransaction] [<CommonParameters>]
Descrizione
Il cmdlet Split-Path restituisce solo la parte specificata di un percorso, ad esempio la directory padre, una directory figlio o un nome file. Può inoltre visualizzare gli elementi a cui il percorso diviso fa riferimento e indicare se il percorso è relativo o assoluto.
È possibile utilizzare questo cmdlet per visualizzare o inviare solo una parte selezionata di un percorso.
Parametri
-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 |
-IsAbsolute
Restituisce TRUE se il percorso è assoluto e FALSE se è relativo. Un percorso assoluto presenta una lunghezza maggiore di zero e non contiene un punto (. ) per indicare il percorso corrente.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Leaf
Restituisce solo l'ultimo elemento o contenitore nel percorso. Nel percorso "C:\Test\Logs\Pass1.log", ad esempio, restituisce solo "Pass1.log".
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-LiteralPath <string[]>
Specifica i percorsi da dividere. A differenza di Path, il valore di LiteralPath viene utilizzato così come viene digitato. Nessun carattere viene interpretato come carattere jolly. Se il percorso include caratteri di escape, è necessario racchiuderli tra virgolette singole tramite le quali si comunica a Windows PowerShell di non interpretare alcun carattere come sequenza di escape.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-NoQualifier
Restituisce il percorso senza il qualificatore. Per il provider FileSystem o Registry, il qualificatore è l'unità del percorso del provider, ad esempio C: o HKCU:. Nel percorso "C:\Test\Logs\Pass1.log", ad esempio, restituisce solo "\Test\Logs\Pass1.log".
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-Parent
Restituisce solo i contenitori padre dell'elemento o del contenitore specificato dal percorso. Nel percorso "C:\Test\Logs\Pass1.log", ad esempio, restituisce "C:\Test\Logs". Parent è il parametro predefinito per la divisione del percorso.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-Path <string[]>
Specifica i percorsi da dividere. È consentito l'utilizzo di caratteri jolly. Se il percorso include spazi, è necessario racchiuderlo tra virgolette doppie. È inoltre possibile reindirizzare un percorso a Split-Path.
|
Obbligatorio? |
true |
|
Posizione? |
1 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByValue, ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-Qualifier
Restituisce solo il qualificatore del percorso specificato. Per il provider FileSystem o Registry, il qualificatore è l'unità del percorso del provider, ad esempio C: o HKCU:.
|
Obbligatorio? |
false |
|
Posizione? |
2 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-Resolve
Visualizza gli elementi cui fa riferimento il percorso diviso risultante anziché visualizzare gli elementi del percorso.
|
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 Split-Path. |
|
Output |
System.String Con il cmdlet Split-Path vengono restituite stringhe di testo. Quando si utilizza il parametro Resolve, Split-Path restituisce una stringa che descrive il percorso degli elementi; non restituisce oggetti che rappresentano gli elementi, ad esempio un oggetto FileInfo o RegistryKey. |
Note
I parametri di divisione del percorso (Qualifier, Parent, Leaf e NoQualifier) sono esclusivi. È possibile utilizzarne uno solo in ogni comando.
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 Split-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>split-path "HKCU:\Software\Microsoft" -qualifier HKCU: Descrizione ----------- Tramite questo comando viene restituito solo il qualificatore (unità) del percorso.
Esempio 2
C:\PS>split-path "C:\Test\Logs\*.log" -leaf -resolve Pass1.log Pass2.log ... Descrizione ----------- Questo comando visualizza i file a cui il percorso diviso fa riferimento. Poiché questo percorso è diviso sull'ultimo elemento (foglia), vengono visualizzati solo i nomi file dei percorsi. Il parametro Resolve indica a Split-Path di visualizzare gli elementi a cui il percorso diviso fa riferimento anziché visualizzare il percorso diviso. Come tutti i comandi Split-Path, questo comando restituisce stringhe. Non restituisce oggetti FileInfo che rappresentano i file.
Esempio 3
C:\PS>split-path "C:\WINDOWS\system32\WindowsPowerShell\V1.0\about_*.txt" C:\WINDOWS\system32\WindowsPowerShell\V1.0 Descrizione ----------- Tramite questo comando vengono restituiti solo i contenitori padre del percorso. Poiché non include alcun parametro per specificare la divisione, Split-Path utilizza la posizione di divisione predefinita, ovvero Parent.
Esempio 4
C:\PS>split-path ".\My Pictures\*.jpg" -IsAbsolute False Descrizione ----------- Questo comando determina se il percorso è relativo o assoluto. In questo caso, poiché il percorso è relativo alla directory corrente rappresentata da un punto (.), restituisce FALSE ($false).
Esempio 5
C:\PS>set-location (split-path $profile) PS C:\Documents and Settings\juneb\My Documents\WindowsPowerShell> Descrizione ----------- Questo comando consente di spostarsi sulla directory che contiene il profilo di Windows PowerShell. Il comando tra parentesi utilizza il cmdlet Split-Path per restituire solo l'elemento padre del percorso archiviato nella variabile $Profile incorporata. Parent è il parametro predefinito per la divisione della posizione, pertanto è possibile ometterlo dal comando. Le parentesi indicano a Windows PowerShell di eseguire prima il comando. Si tratta di un modo pratico per spostarsi su una directory con un percorso lungo.
Esempio 6
C:\PS>'C:\Documents and Settings\User01\My Documents\My Pictures' | split-path C:\Documents and Settings\User01\My Documents Descrizione ----------- Questo comando utilizza un operatore pipeline (|) per inviare un percorso al cmdlet Split-Path. Il percorso è racchiuso tra virgolette per indicare che si tratta di un solo token.
Vedere anche