Contact Info

Crumbtrail

ActiveXperts.com » Administration » Powershell » Powershell 1.0 » Split-Path

Split-Path - Powershell 1.0 CmdLet

ActiveXperts Network Monitor ships with integrated Powershell scripts to monitor complex network. The scripts run out of the box
Download the ActiveXperts Network Monitor FREE version now »

Split-Path

Description
Return part of a path

Usage
Split-Path [-path] string[] [SplitLocationParam]
           [-resolve] [-credential PSCredential]
            [-literalPath string[]] [CommonParameters]

Options
-Path string[]
       The path(s) to be split.{may be piped}
       Wildcards are permitted.

   SplitLocationParam
       One of: -parent,-qualifier,-noQualifier,-leaf or -isAbsolute
          -parent    = Return the parent container of the item (parent folder)
          -qualifier = Return the qualifier of the specified path. (C: or HKCU:)
          -noQualifier = Return the path without the qualifier.
          -leaf  = Return the last item or container in the path.(filename)

   -resolve 
       Display the items that are referenced by the path that remain
       after the split.

   -credential PSCredential
       Use a credential to validate access to the file. Credential represents
       a user-name, such as "User01" or "Domain01\User01", or a PSCredential
       object, such as the one retrieved by using the Get-Credential cmdlet.
       If you type a user name, you will be prompted for a password.
       This parameter is not supported by any PowerShell core cmdlets or providers.
	   
   -literalPath string[]
       The paths to be split.
       Like Path above, only the value is used exactly as typed.
       No characters are interpreted as wildcards. If the path includes any
       escape characters then enclose the path in single quotation marks.

   CommonParameters:
      -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutVariable.

Example(s)
Display a list of .XLS filenames in the docs folder (don't return the whole path):

PS C:\>split-path "C:\Docs\*.xls" -leaf -resolve

Change directory to the folder containing the powershell profile:

PS C:\>Set-Location(split-path $profile -parent)

The above can be simplified with the 'cd' alias for set-location and relying on -parent being the default:

PS C:\>cd(split-path $profile)