Powershell function to post a simple, plaintext status to a Mastodon instance

New-MastodonPost.ps1

<#
    To create an access token,

        * go to settings -> Development
        * Click "New Application"
        * Enter a name
        * Allow "write:statuses"
        * Click Submit
        * Click on the new application to review the keys
        * The "Access token" is the one you need

    Example function call:

        New-MastodonPost -HostName "dataplatform.social" -AccessToken $token -Message "Hello world"

#>

function New-MastodonPost {
	[CmdletBinding()]
	param (
		[Parameter(Mandatory = $true)]
		[string] $HostName,
		[Parameter(Mandatory = $true)]
		[string] $AccessToken,
		[Parameter(Mandatory = $true)]
        [string] $Message
	)

    # Just in case you don't understand what a hostname is
    if ($HostName -like "https://*") { $HostName = $HostName.Substring(8) }
    if ($HostName -like "http://*") { $HostName = $HostName.Substring(7) }
    if ($HostName -like "*/*") { $HostName = $HostName.Substring(0, $HostName.indexOf("/")) }

    # Construct the API URL
    $url = "https://" + $HostName + "/api/v1/statuses?access_token=" + [System.Web.HttpUtility]::UrlEncode($AccessToken)

    # Do the WebRequest thing
    $res = Invoke-WebRequest `
        -Uri $url `
        -Method "POST" `
        -ContentType "application/x-www-form-urlencoded" `
        -UseBasicParsing `
        -Body ("status=" + [System.Web.HttpUtility]::UrlEncode($Message))

    # Return the JSON response
    return($res.Content | ConvertFrom-Json)
}

Check out the [uri] data type if you haven't yet! I think you'll like it. This is how I do mine

# help 'em out
if ($Server -match '://') {
    $Server = ([uri]$Server).DnsSafeHost
} elseif ($Server -match '/@') {
    $Server = $($Server -split "/@" | Select-Object -First 1)
} elseif ($Server.StartsWith("@") -or $Server -match "@") {
    $Server = $($Server -split "@" | Select-Object -Last 1)
}

I posted a variation using Invoke-RestMethod at https://gist.github.com/jdhitsolutions/7bb8fe659cd32a7bfb2debdb7f0bfcfc