PrivateFunctions/Unarchive-SlackChannel.ps1

<#
.SYNOPSIS
    This function unarchives a channel in Slack.
.DESCRIPTION
    This function unarchives a channel in Slack.
#>

function Unarchive-SlackChannel {
    [CmdletBinding(PositionalBinding=$false)]
    [OutputType([Bool])]
    param(
        # The authentication token for Slack
        [Parameter(Mandatory=$true)]
        [ValidateNotNullOrEmpty()]
        [String]$token,

        # The name of the channel to unarchive
        [Parameter(Mandatory=$true)]
        [ValidateNotNullOrEmpty()]
        [String]$channelName,

        # Select the stream where the messages will be directed.
        [Parameter(Mandatory=$false)]
        [ValidateSet("Information", "Warning", "Error", "None")]
        [String]$outputStream = "Error"
    )

    # Convert channel name to channel ID verify that it exists
    $channelID = (Get-SlackChannel -Token $token -ChannelName $channelName).id
    if (!$channelID) {
        Write-OutputMessage "The channel '$($channelName)' cannot be found in Slack." -OutputStream $outputStream -ReturnMessage:$false
        return $false
    }

    # Prepare the API call parameters
    $invokeRestMethodParams = @{
        Uri     = "https://slack.com/api/channels.unarchive"
        Method  = "POST"
        Headers = @{
            "Content-Type" = "application/json"
            Authorization  = "Bearer $($token)"
        }
        Body    = @{
            "channel" = "$($channelID)"
        } | ConvertTo-Json
    }

    # Try to unarchive the channel
    Write-Information "Archiving channel '$($channelName)'."
    try {
        $response = Invoke-RestMethod @invokeRestMethodParams
    }
    catch {
        Write-OutputMessage "Exception occurred while archiving the channel '$($channelName)' in Slack.`r`n$($_.Exception.Message)" -OutputStream $outputStream -ReturnMessage:$false
        return $false
    }

    # Verify that the archiving is successful
    if ($response.ok) {
        Write-Information "Channel '$($channelName)' was unarchived."
        return $true
    }
    else {
        Write-OutputMessage "Failed to unarchive channel '$($channelName)' with the error message:`r`n$($response.error)." -OutputStream $outputStream -ReturnMessage:$false
        return $false
    }
}