public/Step-Up.ps1
|
<#
.SYNOPSIS Navigate upward by n levels (one level by default) or to the first parent directory matching a given search term. .PARAMETER n Number of levels above the starting location. (One by default.) .PARAMETER NamePart Partial directory name for which to search. .EXAMPLE # Set location to the parent of the current directory C:\Windows\System32> up C:\Windows> _ .EXAMPLE # Set location to the grandparent of the current directory C:\Windows\System32> up 2 C:\> _ .EXAMPLE # Set location to the first ancestor of the current directory where the name contains 'win' C:\Windows\System32> up win C:\Windows> _ #> function Step-Up { [OutputType([void], [Management.Automation.PathInfo])] [CmdletBinding(DefaultParameterSetName = 'n')] param( [Parameter(ParameterSetName = 'n', Position = 0)] [byte] $n = 1, [Parameter(ParameterSetName = 'named', Position = 0, Mandatory)] [string] $NamePart, [Alias('FullName', 'Path')] [Parameter(ValueFromPipeline, ValueFromPipelineByPropertyName)] [string] $From = $PWD, [switch] $PassThru ) if ($PSBoundParameters.ContainsKey('PassThru')) { $PSBoundParameters.Remove('PassThru') | out-null } if ($target = Get-Up @PSBoundParameters) { Set-LocationEx -LiteralPath $target -PassThru:$PassThru } } |