FreeDadJokes.psm1
|
function Get-DadJoke() { <# .SYNOPSIS Get a Random Dad Joke on the command line. .DESCRIPTION This function retrieves a random dad joke from the internet. .EXAMPLE Get-DadJoke This example retrieves a random dad joke. .NOTES Author: Michael Free .OUTPUTS System.String. This function outputs two lines of text to the console. #> $jokeAPI = 'https://official-joke-api.appspot.com/random_joke' $testJokeAPI = Invoke-WebRequest -Uri $jokeAPI -Method HEAD -UseBasicParsing if (-not $testJokeAPI.StatusCode -eq 200) { throw 'Joke API Route Unavailable' } $dadJoke = Invoke-RestMethod -Uri $jokeAPI -Method Get if (-not ($dadJoke | Get-Member -Name 'setup') -and -not ($dadJoke | Get-Member -Name 'punchline')) { throw 'setup and punchline object unavailabe in response' } Write-Output $dadJoke.setup Write-Output $dadJoke.punchline } |