Wrapper for the MKLINK command from the legacy cmd.exe terminal

New-Link.ps1

function New-Link {
    [Alias("mklink")]
    param(
        [ValidateSet(
            "SymbolicLink",
            "HardLink",
            "DirectoryLink",
            "Junction"
        )]
        [string]
        $LinkType = "SymbolicLink",
        [Parameter(
            Mandatory,
            Position = 0,
            HelpMessage = "Name of the link."
        )]
        [string]
        $Name,
        [Parameter(
            Mandatory,
            Position = 1,
            ValueFromPipeline = $true,
            HelpMessage = "Path to a file."
        )]
        [ValidateNotNullOrEmpty()]
        [string]
        [System.IO.FileInfo]$Target,
        [switch]
        $PrintVars
    )
    if ($PrintVars) {
        Write-Host "LinkType = |$LinkType|" -ForegroundColor Red
        Write-Host "Name = |$Name|" -ForegroundColor Red
        Write-Host "Target = |$Target|" -ForegroundColor Red
        Write-Host "DebugPreference = $DebugPreference" -ForegroundColor Red
    }
    switch ($LinkType) {
        "SymbolicLink" { cmd.exe /C MKLINK $Name $Target }
        "HardLink" { cmd.exe /C MKLINK /H $Name $Target }
        "DirectoryLink" { cmd.exe /C MKLINK /D $Name $Target }
        "Junction" { cmd.exe /C MKLINK /J $Name $Target }
        Default {
            Write-Warning "The specified type is not recognized."
            Write-Warning "Defaulting to file symbolic link."
            cmd.exe /c MKLINK $Name $Target
        }
    }
}