TeamsFunctions

21.6.13

Public/Functions/Session/Skype/Assert-SkypeOnlineConnection.ps1

# Module: TeamsFunctions
# Function: Session
# Author: David Eberhardt
# Updated: 01-OCT-2020
# Status: Live




function Assert-SkypeOnlineConnection {
  <#
  .SYNOPSIS
    Asserts an established Connection to SkypeOnline
  .DESCRIPTION
    Tests and tries to reconnect to a SkypeOnline connection already established.
  .EXAMPLE
    Assert-SkypeOnlineConnection
    Will run Test-SkypeOnlineConnection and, if successful, stops.
    If unsuccessful, tries to reconnect by running Get-CsTenant to prompt for reconnection.
    If that too is unsuccessful, displays request to reconnect with Connect-Me.
  .INPUTS
    System.Void
  .OUTPUTS
    System.Boolean
  .NOTES
    Calls Test-SkypeOnlineConnection to ascertain session.
  .COMPONENT
    TeamsSession
  .FUNCTIONALITY
    Asserts the connection to MicrosoftTeams (SkypeOnline)
  .LINK
    https://github.com/DEberhardt/TeamsFunctions/tree/master/docs/
  .LINK
    about_TeamsSession
  #>

  [CmdletBinding()]
  [OutputType([Boolean])]
  param() #param

  begin {
    Show-FunctionStatus -Level Deprecated
    $Stack = Get-PSCallStack
    $Called = ($stack.length -ge 3)

  } #begin

  process {

    if (Test-SkypeOnlineConnection) {
      if ( $Called ) {
        return $true
      }
      else {
        try {
          $null = Get-CsTenant -ErrorAction STOP -WarningAction SilentlyContinue
          Write-Verbose -Message '[ASSERT] SkypeOnline: Connected (and session is valid)'
          return
        }
        catch {
          Write-Host '[ASSERT] ERROR: Session is available, but timed out. Please disconnect and create a new session with Connect-SkypeOnline or Connect-Me.' -ForegroundColor Red
          Write-Verbose '[ASSERT] INFO: Connect-Me can be used to disconnect, then connect to multiple Services at once (SkypeOnline, AzureAD & MicrosoftTeams)!'
          return
        }
      }
    }
    else {
      $Sessions = Get-PSSession -WarningAction SilentlyContinue
      $SkypeSession = $Sessions | Where-Object { $_.Computername -match 'online.lync.com' -or $_.ComputerName -eq 'api.interfaces.records.teams.microsoft.com' }
      if ( $SkypeSession ) {
        Write-Verbose '[ASSERT] SkypeOnline Session found. Trying to reconnect... (authentication required)' -Verbose
        try {
          $null = Get-CsTenant -ErrorAction STOP -WarningAction SilentlyContinue
          return $(if ($Called) { $true })
        }
        catch {
          Write-Host '[ASSERT] ERROR: Reconnect unsuccessful. Please disconnect and create a new session with Connect-SkypeOnline or Connect-Me.' -ForegroundColor Red
          return $(if ($Called) { $false })
        }
      }
      else {
        $TeamsSession = $Sessions | Where-Object { $_.Computername -eq 'api.interfaces.records.teams.microsoft.com' }
        if ( $TeamsSession ) {
          Write-Verbose '[ASSERT] SkypeOnline Session found. Trying to reconnect... (authentication required)' -Verbose
          $Connection = Connect-SkypeOnline
          if ( Test-SkypeOnlineConnection ) {
            if ($stack.length -ge 5) {
              return $true
            }
            else {
              try {
                $null = Get-CsTenant -WarningAction SilentlyContinue -ErrorAction Stop
                if ($Called) {
                  return $(if ($Called) { $true } else { $Connection })
                }
              }
              catch {
                return $(if ($Called) { $false })
              }
            }
            else {
              return $Connection
            }
          }
        }
        else {
          Write-Host '[ASSERT] ERROR: You must call the Connect-SkypeOnline cmdlet before calling any other cmdlets. (Connect-Me can be used for multiple connections) ' -ForegroundColor Red
          return $(if ($Called) { $false })
        }
      }
    }
  } #process

  end {

  } #end

} #Assert-SkypeOnlineConnection