Split-Path
Restituisce la parte specificata di un percorso.
Sintassi
ParentSet (Impostazione predefinita)
Split-Path
[-Path] <String[]>
[-Parent]
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
LeafSet
Split-Path
[-Path] <String[]>
-Leaf
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
LeafBaseSet
Split-Path
[-Path] <String[]>
-LeafBase
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
ExtensionSet
Split-Path
[-Path] <String[]>
-Extension
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
QualifierSet
Split-Path
[-Path] <String[]>
-Qualifier
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
NoQualifierSet
Split-Path
[-Path] <String[]>
-NoQualifier
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
IsAbsoluteSet
Split-Path
[-Path] <String[]>
-IsAbsolute
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
LiteralPathSet
Split-Path
-LiteralPath <String[]>
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
Descrizione
Il cmdlet Split-Path restituisce solo la parte specificata di un percorso, ad esempio la cartella padre, una sottocartella o un nome file. Può anche ottenere elementi a cui fa riferimento il percorso di divisione e indicare se il percorso è relativo o assoluto.
È possibile usare questo cmdlet per ottenere o inviare solo una parte selezionata di un percorso.
Esempio
Esempio 1: Ottenere il qualificatore di un percorso
Split-Path -Path "HKCU:\Software\Microsoft" -Qualifier
HKCU:
Questo comando restituisce solo il qualificatore del percorso. Il qualificatore è l'unità.
Esempio 2: Visualizzazione dei nomi dei file
Split-Path -Path "C:\Test\Logs\*.log" -Leaf -Resolve
Pass1.log
Pass2.log
...
Questo comando visualizza i file a cui fa riferimento il percorso diviso. Poiché questo percorso viene suddiviso in base all'ultimo elemento, noto anche come foglia, il comando visualizza solo i nomi dei file.
Il parametro Resolve indica Split-Path di visualizzare gli elementi a cui fa riferimento il percorso diviso, anziché visualizzare il percorso diviso.
Come tutti i Split-Path comandi, questo comando restituisce stringhe. Non restituisce oggetti FileInfo che rappresentano i file.
Esempio 3: Ottenere il contenitore padre
Split-Path -Parent "C:\WINDOWS\system32\WindowsPowerShell\V1.0\about_*.txt"
C:\WINDOWS\system32\WindowsPowerShell\V1.0
Questo comando restituisce solo i contenitori padre del percorso. Poiché non include alcun parametro per specificare la divisione, Split-Path utilizza l'impostazione predefinita della posizione di divisione, ovvero Padre.
Esempio 4: determina se un percorso è assoluto
Split-Path -Path ".\My Pictures\*.jpg" -IsAbsolute
False
Questo comando determina se il percorso è relativo o assoluto. In questo caso, poiché il percorso è relativo alla cartella corrente, rappresentata da un punto (.), restituisce $False.
Esempio 5: Modificare la posizione in un percorso specificato
PS C:\> Set-Location (Split-Path -Path $profile)
PS C:\Documents and Settings\User01\My Documents\WindowsPowerShell>
Questo comando modifica il percorso nella cartella che contiene il profilo di PowerShell.
Il comando tra parentesi usa Split-Path per restituire solo l'elemento padre del percorso archiviato nella variabile $Profile predefinita. Il parametro parent è il parametro di divisione predefinito.
Pertanto, è possibile ometterlo dal comando . Le parentesi indirizzano PowerShell per eseguire prima il comando. Si tratta di un modo utile per passare a una cartella con un nome di percorso lungo.
Esempio 6: Dividere un percorso usando la pipeline
'C:\Documents and Settings\User01\My Documents\My Pictures' | Split-Path
C:\Documents and Settings\User01\My Documents
Questo comando usa un operatore pipeline (|) per inviare un percorso a Split-Path. Il percorso è racchiuso tra virgolette per indicare che si tratta di un singolo token.
Parametri
-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 |
-Extension
Indica che questo cmdlet restituisce solo l'estensione della foglia. Ad esempio, nel percorso C:\Test\Logs\Pass1.logrestituisce solo .log.
Questo parametro è stato introdotto in PowerShell 6.0.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
ExtensionSet
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-IsAbsolute
Indica che questo cmdlet restituisce $True se il percorso è assoluto e $False se è relativo. Un percorso assoluto ha una lunghezza maggiore di zero e non utilizza un punto (.) per indicare il percorso corrente.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
IsAbsoluteSet
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Leaf
Indica che questo cmdlet restituisce solo l'ultimo elemento o contenitore nel percorso. Ad esempio, nel percorso C:\Test\Logs\Pass1.logrestituisce solo Pass1.log.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
LeafSet
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-LeafBase
Indica che questo cmdlet restituisce solo il nome di base della foglia. Ad esempio, nel percorso C:\Test\Logs\Pass1.logrestituisce solo Pass1.
Questo parametro è stato introdotto in PowerShell 6.0.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
LeafBaseSet
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-LiteralPath
Specifica i percorsi da dividere. A differenza di Path, il valore di LiteralPath viene usato esattamente come viene tipizzato. Nessun carattere è interpretato come un carattere jolly. Se il percorso include caratteri di escape, racchiudilo tra virgolette singole. Le virgolette singole indicano a PowerShell di non interpretare alcun carattere come sequenze di escape.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | PSPath, UP |
Set di parametri
LiteralPathSet
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-NoQualifier
Indica che questo cmdlet restituisce il percorso senza il qualificatore. Per i provider del FileSystem o del Registro di sistema, il qualificatore è l'unità del percorso del provider, ad esempio C: o HKCU:. Ad esempio, nel percorso C:\Test\Logs\Pass1.logrestituisce solo \Test\Logs\Pass1.log.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
NoQualifierSet
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-Parent
Indica che questo cmdlet restituisce solo i contenitori padre dell'elemento o del contenitore specificato dal percorso. Ad esempio, nel percorso C:\Test\Logs\Pass1.log, restituisce C:\Test\Logs.
Il parametro parent è il parametro di divisione predefinito.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
ParentSet
| 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 i percorsi da dividere. Sono consentiti caratteri jolly. Se il percorso include spazi, racchiuderlo tra virgolette. È anche possibile inviare tramite pipe un percorso a questo cmdlet.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | True |
| DontShow: | False |
Set di parametri
ParentSet
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
LeafSet
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
LeafBaseSet
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
ExtensionSet
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
QualifierSet
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
NoQualifierSet
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
IsAbsoluteSet
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-Qualifier
Indica che questo cmdlet restituisce solo il qualificatore del percorso specificato. Per i provider del FileSystem o del Registro di sistema, il qualificatore è l'unità del percorso del provider, ad esempio C: o HKCU:.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
QualifierSet
| Posizione: | 1 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-Resolve
Indica che questo cmdlet visualizza gli elementi a cui fa riferimento il percorso di divisione risultante anziché visualizzare gli elementi del percorso.
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 |
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 stringhe di testo. Quando si specifica il parametro Resolve, restituisce una stringa che descrive la posizione degli elementi. Non restituisce oggetti che rappresentano gli elementi, ad esempio un FileInfo o oggetto RegistryKey.
Boolean
Quando si specifica il parametro IsAbsolute, questo cmdlet restituisce un valore booleano.
Note
I parametri della posizione divisa (Qualifier, Parent, Extension, Leaf, LeafBasee NoQualifier) sono esclusivi. È possibile usare solo uno in ogni comando.
I cmdlet che contengono il sostantivo Path (i cmdlet Path) funzionano con 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. Usarli nel modo in cui è possibile usare Dirname, Normpath, Realpath, Joino altri manipolatori di percorso.
È possibile usare i cmdlet path insieme a diversi provider. Questi includono i provider FileSystem, Registry e Certificate.
Split-Pathè progettato per lavorare con i dati esposti da qualsiasi provider. Per elencare i provider disponibili nella sessione, digitareGet-PSProvider. Per altre informazioni, consultare about_Providers.