New-PSDriveHere.ps1

#requires -version 2.0

Function New-PSDriveHere {

<#
.Synopsis
Create a new PSDrive at the current location.

.Description
This function will create a new PSDrive at the specified location. The default is the current location, but you can specify any PSPath. The function will take the last word of the path and use it as the name of the new PSDrive. If you prefer to use the first word of the location, use -First. If you prefer to specify a totally different name, then use the -Name parameter.
.Parameter Path
The path for the new PSDrive. The default is the current location.
.Parameter Name
The name for the new PSDrive. The default is the last word in the specified location, 
unless you use -First.
.Parameter First
Use the first word of the current location for the new PSDrive.
.Parameter SetLocation
Set location to this new drive.
.Example
PS C:\users\jeff\Documents\Enterprise Mgmt Webinar> new-psdrivehere

Name           Used (GB)     Free (GB) Provider      Root                                 CurrentLocation
----           ---------     --------- --------      ----                                 ---------------
Webinar                         146.57 FileSystem    C:\users\jeff\Documents\Enter...
.Example
PS C:\users\jeff\Documents\Enterprise Mgmt Webinar> new-psdrivehere -first

Name           Used (GB)     Free (GB) Provider      Root                                 CurrentLocation
----           ---------     --------- --------      ----                                 ---------------
Enterprise                      146.57 FileSystem    C:\users\jeff\Documents\Enter...
.Example
PS C:\> new-psdrivehere HKLM:\software\microsoft

Name           Used (GB)     Free (GB) Provider      Root                                 CurrentLocation
----           ---------     --------- --------      ----                                 ---------------
microsoft                              Registry      HKEY_LOCAL_MACHINE\software\micr...

.Example
PS C:\> new-psdrivehere -Path "\\jdh-nvnas\files\powershell" -Name PSFiles            
                                                                                      
Name           Used (GB)     Free (GB) Provider      Root                                 CurrentLocation
----           ---------     --------- --------      ----                                 ---------------
PSFiles                                FileSystem    \\jdh-nvnas\files\powershell     
.Example
PS C:\Users\Jeff\Documents\DeepDive> new-psdrivehere . DeepDive -setlocation

Name           Used (GB)     Free (GB) Provider      Root                                 CurrentLocation
----           ---------     --------- --------      ----                                 ---------------
DeepDive                        130.53 FileSystem    C:\Users\Jeff\Documents\DeepDive


PS DeepDive:\>

Set a new PSDrive and change to it.

.Inputs
None. You cannot pipe to this function.
.Outputs
System.Management.Automation.PSDrive
.Link
http://jdhitsolutions.com/blog/2010/08/new-psdrivehere/
.Link
    Get-PSDrive
    New-PSDrive
    
.Notes
 NAME:      New-PSDriveHere
 VERSION:   2.0
 AUTHOR:    Jeffery Hicks
 LASTEDIT:  Octber 15, 2011
 
Learn more about PowerShell:
http://jdhitsolutions.com/blog/essential-powershell-resources/

#>

[cmdletBinding(SupportsShouldProcess=$True)]

Param(
[Parameter(Position=0)]
[ValidateScript({Test-Path $_})]
[string]$Path=".",
	
[Parameter(Position=1)]
[string]$Name,

[switch]$First,

[Alias("cd")]
[switch]$SetLocation
)

#get the specified location
$location=Get-Item -Path $path

#did the user specify a name?
if ($Name) {
		Write-Verbose "Name parameter used for $name"	
} #if $name
else {	
		if ($first) {
		    $pattern="^\w+"
		}
		else {
		    $pattern="\w+$"
		}
		#Make sure name contains valid characters. This function
		#should work for all but the oddest named folders.

		if ($location.Name -match $pattern) {
		    $name=$matches[0]
		}
		else {
		    #The location has something odd about it so bail out
    		Write-Warning "$path doesn't meet the criteria"
			Break
 			}
		
	} #else $name not specified

    #verify a PSDrive doesn't already exist
    Write-Verbose "Testing $($name):"
   
	If (-not (Test-Path -path "$($name):")) {
        Write-Verbose "Creating PSDrive for $name"
        New-PSDrive -Name $name -PSProvider $location.PSProvider -Root $Path `
        -Description "Created $(get-date)" -scope Global  
        if ($SetLocation) {
            Write-Verbose "Setting location to $($name):"
            set-location -Path "$($name):"
        }      
    }
    else {
        Write-Warning "A PSDrive for $name already exists"
    }

} #function

#create an alias for the function
Set-Alias -Name npsd -Value New-PSDriveHere