Split-Path
Retourneert het opgegeven deel van een pad.
Syntax
ParentSet (Standaard)
Split-Path
[-Path] <String[]>
[-Parent]
[-Resolve]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
NoQualifierSet
Split-Path
[-Path] <String[]>
[-NoQualifier]
[-Resolve]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
LeafSet
Split-Path
[-Path] <String[]>
[-Leaf]
[-Resolve]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
QualifierSet
Split-Path
[-Path] <String[]>
[-Qualifier]
[-Resolve]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
IsAbsoluteSet
Split-Path
[-Path] <String[]>
[-Resolve]
[-IsAbsolute]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
LiteralPathSet
Split-Path
-LiteralPath <String[]>
[-Resolve]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
Description
De Split-Path cmdlet retourneert alleen het opgegeven deel van een pad, zoals de bovenliggende map, een submap of een bestandsnaam. Er kunnen ook items worden opgehaald waarnaar wordt verwezen door het gesplitste pad en nagaan of het pad relatief of absoluut is.
U kunt deze cmdlet gebruiken om alleen een geselecteerd deel van een pad op te halen of te verzenden.
Voorbeelden
Voorbeeld 1: De kwalificatie van een pad ophalen
PS C:\> Split-Path -Path "HKCU:\Software\Microsoft" -Qualifier
HKCU:
Met deze opdracht wordt alleen de kwalificatie van het pad geretourneerd. De kwalificatie is de drive.
Voorbeeld 2: Bestandsnamen weergeven
PS C:\> Split-Path -Path "C:\Test\Logs\*.log" -Leaf -Resolve
Pass1.log
Pass2.log
...
Met deze opdracht worden de bestanden weergegeven waarnaar wordt verwezen door het gesplitste pad. Omdat dit pad is gesplitst naar het laatste item, ook wel het blad genoemd, geeft de opdracht alleen de bestandsnamen weer.
De parameter Resolve vertelt Split-Path om de items weer te geven waarnaar het splitspad verwijst, in plaats van het gesplitste pad weer te geven.
Net als alle opdrachten splitspad, retourneert deze opdracht tekenreeksen. Het retourneert geen FileInfo objecten die de bestanden vertegenwoordigen.
Voorbeeld 3: De bovenliggende container ophalen
PS C:\> Split-Path -Path "C:\WINDOWS\system32\WindowsPowerShell\V1.0\about_*.txt"
C:\WINDOWS\system32\WindowsPowerShell\V1.0
Met deze opdracht worden alleen de bovenliggende containers van het pad geretourneerd. Omdat deze geen parameters bevat om de splitsing op te geven, gebruikt splitspad de standaardlocatie voor splitsen gebruikt. Dit is bovenliggende.
Voorbeeld 4: bepaalt of een pad absoluut is
PS C:\> Split-Path -Path ".\My Pictures\*.jpg" -IsAbsolute
False
Met deze opdracht wordt bepaald of het pad relatief of absoluut is. In dit geval, omdat het pad relatief is ten opzichte van de huidige map, die wordt vertegenwoordigd door een punt (.), retourneert het $False.
Voorbeeld 5: Locatie wijzigen in een opgegeven pad
PS C:\> Set-Location (Split-Path -Path $profile)
PS C:\Documents and Settings\User01\My Documents\WindowsPowerShell>
Met deze opdracht wordt uw locatie gewijzigd in de map die het PowerShell-profiel bevat.
De opdracht tussen haakjes maakt gebruik van Split-Path- om alleen het bovenliggende pad te retourneren dat is opgeslagen in de ingebouwde $Profile variabele. De parameter Bovenliggende is de standaardparameter voor gesplitste locatie. Daarom kunt u deze weglaten uit de opdracht. De haakjes leiden PowerShell om de opdracht eerst uit te voeren. Dit is een handige manier om naar een map met een lange padnaam te gaan.
Voorbeeld 6: Een pad splitsen met behulp van de pijplijn
PS C:\> 'C:\Documents and Settings\User01\My Documents\My Pictures' | Split-Path
C:\Documents and Settings\User01\My Documents
Deze opdracht maakt gebruik van een pijplijnoperator (|) om een pad te verzenden naar splitspad. Het pad staat tussen aanhalingstekens om aan te geven dat het één token is.
Parameters
-Credential
Opmerking
Deze parameter wordt niet ondersteund door providers die zijn geïnstalleerd met PowerShell. Als u een andere gebruiker wilt imiteren of uw referenties wilt verhogen bij het uitvoeren van deze cmdlet, gebruikt u Invoke-Command-.
Parametereigenschappen
| Type: | PSCredential |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-IsAbsolute
Geeft aan dat deze cmdlet $True retourneert als het pad absoluut is en $False als het relatief is. Een absoluut pad heeft een lengte die groter is dan nul en gebruikt geen punt (.) om het huidige pad aan te geven.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
IsAbsoluteSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Leaf
Geeft aan dat deze cmdlet alleen het laatste item of de laatste container in het pad retourneert.
In het pad C:\Test\Logs\Pass1.logwordt bijvoorbeeld alleen Pass1.log geretourneerd.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
LeafSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-LiteralPath
Hiermee geeft u de paden die moeten worden gesplitst. In tegenstelling tot Pad, wordt de waarde van LiteralPath- exact gebruikt zoals deze is getypt. Er worden geen tekens geïnterpreteerd als jokertekens. Als het pad escape-tekens bevat, zet het dan tussen enkele aanhalingstekens. Enkele aanhalingstekens zorgen ervoor dat PowerShell geen tekens als escapesequenties interpreteert.
Parametereigenschappen
| Type: | String[] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | PSPath |
Parametersets
LiteralPathSet
| Position: | Named |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-NoQualifier
Geeft aan dat deze cmdlet het pad retourneert zonder de kwalificatie.
Voor de bestandssysteem- of registerproviders is de kwalificatie het station van het providerpad, zoals C: of HKCU:.
In het pad C:\Test\Logs\Pass1.logwordt bijvoorbeeld alleen \Test\Logs\Pass1.log geretourneerd.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
NoQualifierSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-Parent
Geeft aan dat deze cmdlet alleen de bovenliggende containers van het item of van de container retourneert die door het pad zijn opgegeven.
In het pad C:\Test\Logs\Pass1.logwordt bijvoorbeeld C:\Test\Logs geretourneerd.
De parameter Bovenliggende is de standaardparameter voor gesplitste locatie.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
ParentSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-Path
Hiermee geeft u de paden die moeten worden gesplitst. Jokertekens zijn toegestaan. Als het pad spaties bevat, plaatst u het tussen aanhalingstekens. U kunt ook een pad naar deze cmdlet doorsluisen.
Parametereigenschappen
| Type: | String[] |
| Default value: | None |
| Ondersteunt jokertekens: | True |
| DontShow: | False |
Parametersets
ParentSet
| Position: | 0 |
| Verplicht: | True |
| Waarde uit pijplijn: | True |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
NoQualifierSet
| Position: | 0 |
| Verplicht: | True |
| Waarde uit pijplijn: | True |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
LeafSet
| Position: | 0 |
| Verplicht: | True |
| Waarde uit pijplijn: | True |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
QualifierSet
| Position: | 0 |
| Verplicht: | True |
| Waarde uit pijplijn: | True |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
IsAbsoluteSet
| Position: | 0 |
| Verplicht: | True |
| Waarde uit pijplijn: | True |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-Qualifier
Geeft aan dat deze cmdlet alleen de kwalificatie van het opgegeven pad retourneert. Voor de bestandssysteem- of registerproviders is de kwalificatie het station van het providerpad, zoals C: of HKCU:.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
QualifierSet
| Position: | 1 |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-Resolve
Geeft aan dat met deze cmdlet de items worden weergegeven waarnaar wordt verwezen door het resulterende gesplitste pad in plaats van de padelementen weer te geven.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-UseTransaction
Bevat de opdracht in de actieve transactie. Deze parameter is alleen geldig wanneer een transactie wordt uitgevoerd. Zie about_Transactions voor meer informatie.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | usetx |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.
Invoerwaarden
String
U kunt een tekenreeks die een pad naar deze cmdlet bevat, doorgeven.
Uitvoerwaarden
System.String, System.Boolean
Split-Path retourneert tekenreeksen. Wanneer u de parameter Resolve opgeeft, retourneert Split-Path een tekenreeks die de locatie van de items beschrijft; het retourneert geen objecten die de items vertegenwoordigen, zoals een FileInfo- of RegistryKey-object.
Wanneer u de parameter IsAbsolute opgeeft, retourneert Split-Path een booleaanse waarde.
Notities
De parameters voor gesplitste locatie (Kwalificatie, Bovenliggende, Leaf-en NoQualifier-) zijn exclusief. U kunt slechts één in elke opdracht gebruiken.
De cmdlets die het Pad zelfstandig naamwoord (de cmdlets Path) bevatten, werken met padnamen en retourneren de namen in een beknopte indeling die alle PowerShell-providers kunnen interpreteren. Ze zijn ontworpen voor gebruik in programma's en scripts waarin u alle of een deel van een padnaam in een bepaalde indeling wilt weergeven. Gebruik ze op de manier waarop u Dirname, Normpath, Realpath, Joinof andere padmanipulors zou gebruiken.
U kunt de Path cmdlets samen met verschillende providers gebruiken. Dit zijn onder andere de bestandssysteem-, register- en certificaatproviders.
Split-Path is ontworpen om te werken met de gegevens die door elke provider worden weergegeven. Als u de providers wilt weergeven die beschikbaar zijn in uw sessie, typt u
Get-PSProvider. Zie about_Providers voor meer informatie.