Get-ICMediaServerStatus.ps1

<#
# AUTHOR : Paul McGurn
# DATE   : 02/10/2021
#>
#NOTE: Media Server REST API is not enabled by default.  If this command returns a error 404 or 401, that is likely why.

function Get-ICMediaServerStatus() {
  <#
  .SYNOPSIS
    Returns the media server / command server status for each linked CIC server in an arraylist
  .DESCRIPTION
    Returns the media server / command server status for each linked CIC server in an arraylist
  .PARAMETER Server
    The media server to query
  .PARAMETER User
    The media server username to log on with
  .PARAMETER Password
    The media server password to log on with.  Must be of type System.SecureString for adequate runtime security.
  .PARAMETER UseHttps
    Whether to use http (default) or https to interace with Media Server REST API.  The Media server needs to have these two settings enabled 
    in order to use https
    * Recording Retrieval Use Mutual Authentication
    * Recording Retrieval HTTPS Required
  .EXAMPLE
    $user = 'someuser'
    $password = ConvertTo-SecureString 'Super$strong##' -AsPlainText
    $s = Get-ICMediaServerStatus -Server 'mymediaserver.example.com' -User $user -Password $password
  #>
  [CmdletBinding()]
  Param(
    [Parameter(Mandatory = $true)]  [Alias("Computer", "MediaServer")] $Server,
    [Parameter(Mandatory = $true)] [Alias("username", "id")] $User,
    [Parameter(Mandatory = $true)] [Alias("pass")] [SecureString]$Password,
    [Parameter(Mandatory = $false)] [bool] $UseHttps = $false
  )

  $cred = New-Object System.Management.Automation.PSCredential $User, $Password
    
  if ($UseHttps) {
    $protocol = 'https://'
  }
  else {
    $protocol = 'http://'
  }
  $uri = $protocol + $server + ":8102/api/v1/commandservers"  #Port 8102 is the default port for this API

  $response = Invoke-RestMethod -Uri $uri -Method GET -Credential $cred -AllowUnencryptedAuthentication
  $response.commandServers
}