functions/Resolve-WUFullPath.ps1
|
<#
.SYNOPSIS Converts a relative path to an absolute path. .DESCRIPTION The path does not have to exist. However, base path must exist. If the base path directory does not exist, it will be created. Also, for now, it doesn't verify the validity of the path. .EXAMPLE PS C:\>Resolve-WUFullPath -Path 'power*ise.exe' -BasePath 'C:\Windows\System32\WindowsPowerShell\v1.0' Returns C:\Windows\System32\WindowsPowerShell\v1.0\powershell_ise.exe .EXAMPLE PS C:\> Resolve-WUFullPath 'ttttttt' -BasePath '/' Returns C:\ttttttt #> [CmdletBinding( SupportsShouldProcess, DefaultParameterSetName = 'Path' )] param ( # Specifies a path to one or more locations. Wildcards are permitted. The default location is the current directory (.). [Parameter(Position = 0, ParameterSetName = 'Path', ValueFromPipeline, ValueFromPipelineByPropertyName)] [ValidateNotNullOrEmpty()] [SupportsWildcards()] [string[]] $Path = $PWD.Path, # Specifies a path to one or more locations. Unlike the Path parameter, the value of the LiteralPath parameter is used exactly as it is typed. No characters are interpreted as wildcards. If the path includes escape characters, enclose it in single quotation marks. Single quotation marks tell Windows PowerShell not to interpret any characters as escape sequences. The default location is the current directory (.). [Parameter(Position = 0, ParameterSetName = 'LiteralPath', ValueFromPipelineByPropertyName )] [Alias('PSPath')] [ValidateNotNullOrEmpty()] [string[]] $LiteralPath, # Specify key names of the registry. Converts specified key names to path. The default location is the current directory (.). [Parameter(Position = 0, ParameterSetName = 'KeyName', ValueFromPipelineByPropertyName )] [ValidateNotNullOrEmpty()] [string[]] $KeyName, # Specify the beginning of a fully qualified path. The default location is the current directory (.). [Parameter(ParameterSetName = 'Path')] [Parameter(ParameterSetName = 'LiteralPath')] [ValidateNotNullOrEmpty()] [string] $BasePath = $PWD.Path, # If specified, creates the parent directory of the obtained path. [Parameter(ParameterSetName = 'Path')] [Parameter(ParameterSetName = 'LiteralPath')] [switch] $Parents ) Set-StrictMode -Version 'Latest' if ($PSCmdlet.ParameterSetName -eq 'KeyName') { $regPaths = @() foreach ($aKeyName in $KeyName) { if (!($aKeyName -match ':')) { $aKeyName = "Registry::$aKeyName" } $regPaths += $aKeyName } return $regPaths } if ((Test-Path -LiteralPath $BasePath -PathType Leaf)) { Write-Error "BasePath '$BasePath' is not a Directory" return } if ($Parents -and !(Test-Path -LiteralPath $BasePath -PathType Container)) { mkdir $BasePath | Out-Null } if (!(Test-Path -LiteralPath $BasePath -PathType Container -ErrorAction Stop)) { Write-Error "BasePath '$BasePath' must exist." return } try { Push-Location -LiteralPath $BasePath $paths = @() if ($PSCmdlet.ParameterSetName -eq 'Path') { foreach ($aPath in $Path) { if ((Test-Path -Path $aPath)) { # Resolve any wildcards that might be in the path $provider = $null $paths += $PSCmdlet.SessionState.Path.GetResolvedProviderPathFromPSPath($aPath, [ref]$provider) } else { $paths += $PSCmdlet.SessionState.Path.GetUnresolvedProviderPathFromPSPath($aPath) } } } else { foreach ($aPath in $LiteralPath) { $paths += $PSCmdlet.SessionState.Path.GetUnresolvedProviderPathFromPSPath($aPath) } } if ($Parents) { [string[]]$parentPaths = Split-Path $paths -Parent foreach ($parentPath in $parentPaths) { if (!(Test-Path -LiteralPath $parentPath)) { Write-Verbose "Create the directory '$parentPath'." mkdir $parentPath | Out-Null } } } return $paths } finally { Pop-Location } |