Github Git.IO Link Shortener Client

New-GitIoLink.ps1

function New-GitIoLink {
    <#
    .SYNOPSIS
        Creates a git.io shortened link to a git file
    .DESCRIPTION
        Git.IO link shortener, useful for making short links to repositories or files for use in weblinks, twitter, or tools such as iex (iwr -useb $uri) for running snippets of code
        *WARNING* Once you create a link, it becomes immutable, so be very careful and practice on non-essential links first!
    .EXAMPLE
        New-GitIoLink 'https://www.github.com/notarealsitehopefully'
        Create a link with a random shortname

        ==SAMPLE OUTPUT==
        Link                 Target
        ----                 ------
        https://git.io/fjMxf https://www.github.com/notarealsitehopefully
    .EXAMPLE
        New-GitIoLink https://github.com/powershell/powershell/tree/master powershell
        Create a named Git.io link

        ==SAMPLE OUTPUT==
        Link                      Target
        ----                      ------
        https://git.io/powershell https://github.com/powershell/powershell/tree/master
    #>

    [CmdletBinding()]
    param (
        #The Github or Gist URI that you wish to link to.
        [Parameter(Mandatory, ValueFromPipeline, ValueFromPipelineByPropertyName)][URI]$URI,
        #An optional custom name for your link. https://git.io/<shortname>
        [String]$ShortName
    )

    $Body = "url=$URI"
    if ($ShortName) { $body += "&code=$ShortName" }
    $result = Invoke-WebRequest -useb -erroraction stop -body $Body -method POST -uri 'https://git.io'
    if ($Result -and $result.statuscode -eq 201) {
        $Link = [uri]($result.headers.location | Select-Object -First 1)
        if ($ShortName) {
            $LinkShortName = $Link.segments[1]
            if ($LinkShortName -ne $ShortName) { Write-Warning "You requested shortname '$shortname' but URI has already been shortened to '$LinkShortName'" }
        }
        [PSCustomObject]@{
            Link   = $Link
            Target = $result.Content
        }
    }
}