Grab a random catfact from catfact.ninja

get-catfact.ps1

function get-catfact {
    <#
    .SYNOPSIS
    Grab a random catfact from catfact.ninja.  
    
    .DESCRIPTION
    Grabs a random catfact from catfact.ninja and either says it using speechsynth, or displays to the screen.  
    
    .PARAMETER say
    Speaks the cat fact
    
    .EXAMPLE
    ps>get-catfact

    Cats are man's adorable little serial killers.
    
    #>
    
    param (
        [switch]$say
    )
    [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls -bor [Net.SecurityProtocolType]::Tls11 -bor [Net.SecurityProtocolType]::Tls12
    
    $catfact = (convertfrom-json (Invoke-WebRequest -UseBasicParsing -Uri https://catfact.ninja/fact)).fact

    if ($say) {
        Add-Type -AssemblyName System.Speech
        $global:SpeechSynth = New-Object System.Speech.Synthesis.SpeechSynthesizer
        $global:SpeechSynth.Speak("did you know?")
        $global:SpeechSynth.Speak($CatFact)
    }
    else {
        $catfact
    }
}