TeamsFunctions

22.18.0

Public/CallQueue/New-TeamsCallQueue.ps1

# Module: TeamsFunctions
# Function: CallQueue
# Author: David Eberhardt
# Updated: 01-DEC-2020
# Status: Live
#VALIDATE Adding Users where SIP and UPN are different results in error?
#TEST WelcomeTextToSpeechPrompt - Parametername is a guess based on SharedVoicemail - Could be named completely different.
#CHECK WelcomeMessage input is ONE parameter for both TTV and File, ShareVoicemail params are TWO params separately.
#CHECK Reasoning for TWO is: both can be specified, clear input, but bloat; Reason for ONE is: Neat, can identify anyway - Harmonise?
#TODO Add EnableOverflowSharedVoicemailSuppressSystemMessage and EnableTimeoutSharedVoicemailSuppressSystemMessage (or shorter param?)
function New-TeamsCallQueue {
  <#
  .SYNOPSIS
    New-CsCallQueue with UPNs instead of IDs
  .DESCRIPTION
    Does all the same things that New-CsCallQueue does, but differs in a few significant respects:
    UserPrincipalNames can be provided instead of IDs, FileNames (FullName) can be provided instead of IDs
    File Import is handled by this Script
    Small changes to defaults (see Parameter UseMicrosoftDefaults for details)
    Partial implementation is possible, output will show differences.
  .PARAMETER Name
    Name of the Call Queue. Name will be normalised (unsuitable characters are filtered)
    Used as the DisplayName - Visible in Teams
  .PARAMETER UseMicrosoftDefaults
    This script uses different default values for some parameters than New-CsCallQueue
    Using this switch will instruct the Script to adhere to Microsoft defaults.
    ChangedPARAMETER: This Script Microsoft Reason:
    - OverflowThreshold: 10 50 Smaller Queue Size (Waiting Callers) more universally useful
    - TimeoutThreshold: 30s 1200s Shorter Threshold for timeout more universally useful
    - UseDefaultMusicOnHold: TRUE* NONE ONLY if neither UseDefaultMusicOnHold nor MusicOnHoldAudioFile are specificed
    This only affects parameters which are NOT specified when running the script.
  .PARAMETER AgentAlertTime
    Optional. Time in Seconds to alert each agent. Works depending on Routing method
    Size AgentAlertTime and TimeoutThreshold depending on Routing method and # of Agents available.
  .PARAMETER AllowOptOut
    Optional Switch. Allows Agents to Opt out of receiving calls from the Call Queue
  .PARAMETER UseDefaultMusicOnHold
    Optional Switch. Indicates whether the default Music On Hold should be used.
  .PARAMETER Greeting
    Optional. Text-To-Voice String or Path to Audio File to be used as a Welcome message
    Accepted Text-To-Voice Strings: Minimum 10, Maximum 1000 characters.
    Accepted Audio File Formats: MP3, WAV or WMA format, max 5MB
  .PARAMETER MusicOnHoldAudioFile
    Optional. Path to Audio File to be used as Music On Hold.
    Accepted Formats: MP3, WAV or WMA format, max 5MB
    If not provided, UseDefaultMusicOnHold is set to TRUE
  .PARAMETER OverflowAction
    Optional. Action to be taken if the Queue size limit (OverflowThreshold) is reached
    Forward requires specification of OverflowActionTarget
    Default: DisconnectWithBusy, Values: DisconnectWithBusy, Forward, VoiceMail, SharedVoiceMail
  .PARAMETER OverflowActionTarget
    Situational. Required only if OverflowAction is not DisconnectWithBusy
    UserPrincipalName of the Target
  .PARAMETER OverflowSharedVoicemailTextToSpeechPrompt
    Situational. Text to be read for a Shared Voicemail greeting. Requires LanguageId
    Required if OverflowAction is SharedVoicemail and OverflowSharedVoicemailAudioFile is $null
  .PARAMETER OverflowSharedVoicemailAudioFile
    Situational. Path to the Audio File for a Shared Voicemail greeting
    Required if OverflowAction is SharedVoicemail and OverflowSharedVoicemailTextToSpeechPrompt is $null
  .PARAMETER EnableOverflowSharedVoicemailTranscription
    Situational. Boolean Switch. Requires specification of LanguageId
    Enables a transcription of the Voicemail message to be sent to the Group mailbox
  .PARAMETER OverflowThreshold
    Optional. Time in Seconds for the OverflowAction to trigger
    Default: 30s, Microsoft Default: 50s (See Parameter UseMicrosoftDefaults)
  .PARAMETER TimeoutAction
    Optional. Action to be taken if the TimeoutThreshold is reached
    Forward requires specification of TimeoutActionTarget
    Default: Disconnect, Values: Disconnect, Forward, VoiceMail, SharedVoiceMail
  .PARAMETER TimeoutActionTarget
    Situational. Required only if TimeoutAction is not Disconnect
    UserPrincipalName of the Target
  .PARAMETER TimeoutSharedVoicemailTextToSpeechPrompt
    Situational. Text to be read for a Shared Voicemail greeting. Requires LanguageId
    Required if TimeoutAction is SharedVoicemail and TimeoutSharedVoicemailAudioFile is $null
  .PARAMETER TimeoutSharedVoicemailAudioFile
    Situational. Path to the Audio File for a Shared Voicemail greeting
    Required if TimeoutAction is SharedVoicemail and TimeoutSharedVoicemailTextToSpeechPrompt is $null
  .PARAMETER EnableTimeoutSharedVoicemailTranscription
    Situational. Boolean Switch. Requires specification of LanguageId
    Enables a transcription of the Voicemail message to be sent to the Group mailbox
  .PARAMETER TimeoutThreshold
    Optional. Time in Seconds for the TimeoutAction to trigger
    Default: 30s, Microsoft Default: 1200s (See Parameter UseMicrosoftDefaults)
  .PARAMETER RoutingMethod
    Optional. Describes how the Call Queue is hunting for an Agent.
    Serial will Alert them one by one in order specified (Distribution lists will contact alphabethically)
    Attendant behaves like Parallel if PresenceBasedRouting is used.
    Default: Attendant, Values: Attendant, Serial, RoundRobin, LongestIdle
  .PARAMETER PresenceBasedRouting
    Optional. Default: TRUE. If used alerts Agents only when they are available (Teams status).
    This behaviour changed to TRUE in MicrosoftTeams v4.7.0
  .PARAMETER ConferenceMode
    Optional. Will establish a conference instead of a direct call and should help with connection time.
    Default: TRUE, Microsoft Default: FALSE
    This behaviour changed to TRUE in MicrosoftTeams v4.7.0
  .PARAMETER DistributionLists
    Optional. Display Names of DistributionLists or Groups. Their members are to become Agents in the Queue.
    Mutually exclusive with TeamAndChannel. Can be combined with Users.
    Will be parsed after Users if they are specified as well.
    To be considered for calls, members of the DistributionsLists must be Enabled for Enterprise Voice.
  .PARAMETER Users
    Optional. UserPrincipalNames of Users that are to become Agents in the Queue.
    Mutually exclusive with TeamAndChannel. Can be combined with DistributionLists.
    Will be parsed first. Order is only important if Serial Routing is desired (See Parameter RoutingMethod)
    Users are only added if they have a PhoneSystem license and are or can be enabled for Enterprise Voice.
  .PARAMETER ChannelOwner
    Optional. UserPrincipalName of a owner for the Channel. Unknown use-case right now. Feeds Parameter ChannelUserObjectId
    Users are only added if they have a PhoneSystem license and are or can be enabled for Enterprise Voice.
  .PARAMETER TeamAndChannel
    Optional. Uses a Channel to route calls to. Members of the Channel become Agents in the Queue.
    Mutually exclusive with Users and DistributionLists.
    Acceptable format for Team and Channel is "TeamIdentifier\ChannelIdentifier".
    Acceptable Identifier for Teams are GroupId (GUID) or DisplayName. NOTE: DisplayName may not be unique.
    Acceptable Identifier for Channels are Id (GUID) or DisplayName.
  .PARAMETER ResourceAccountsForCallerId
    Optional. Resource Account to be used for allowing Agents to use its number as a Caller Id.
  .PARAMETER LanguageId
    Optional Language Identifier indicating the language that is used to play shared voicemail prompts.
    This parameter becomes a required parameter If either OverflowAction or TimeoutAction is set to SharedVoicemail.
  .PARAMETER AuthorizedUsers
    Optional. Users allowed to change certain aspects of the Call Queue (like Greetings)
    These settings are governed by the assigned CsTeamsVoiceApplicationsPolicy (assigned to the User)
  .EXAMPLE
    New-TeamsCallQueue -Name "My Queue"
 
    Creates a new Call Queue "My Queue" with the Default Music On Hold
    All other values not specified default to optimised defaults (See Parameter UseMicrosoftDefaults)
  .EXAMPLE
    New-TeamsCallQueue -Name "My Queue" -UseMicrosoftDefaults
 
    Creates a new Call Queue "My Queue" with the Default Music On Hold
    All values not specified default to Microsoft defaults for New-CsCallQueue (See Parameter UseMicrosoftDefaults)
  .EXAMPLE
    New-TeamsCallQueue -Name "My Queue" -OverflowThreshold 5 -TimeoutThreshold 90
 
    Creates a new Call Queue "My Queue" and sets it to overflow with more than 5 Callers waiting and a timeout window of 90s
    All values not specified default to optimised defaults (See Parameter UseMicrosoftDefaults)
  .EXAMPLE
    New-TeamsCallQueue -Name "My Queue" -MusicOnHoldAudioFile C:\Temp\Moh.wav -Greeting C:\Temp\WelcomeMessage.wmv
 
    Creates a new Call Queue "My Queue" with custom Audio Files
    All values not specified default to optimised defaults (See Parameter UseMicrosoftDefaults)
  .EXAMPLE
    New-TeamsCallQueue -Name "My Queue" -AgentAlertTime 15 -RoutingMethod Serial -AllowOptOut:$false -DistributionLists @(List1@domain.com,List2@domain.com)
 
    Creates a new Call Queue "My Queue" alerting every Agent nested in Azure AD Groups List1@domain.com and List2@domain.com in sequence for 15s.
    All values not specified default to optimised defaults (See Parameter UseMicrosoftDefaults
  .EXAMPLE
    New-TeamsCallQueue -Name "My Queue" -OverflowAction Forward -OverflowActionTarget SIP@domain.com -TimeoutAction Voicemail
 
    Creates a new Call Queue "My Queue" forwarding to SIP@domain.com for Overflow and to Voicemail when it times out.
    All values not specified default to optimised defaults (See Parameter UseMicrosoftDefaults)
  .INPUTS
    System.String
  .OUTPUTS
    System.Object
  .NOTES
    Audio Files, if not found will result in this option not being configured.
    Warnings are displayed, but default options or none are taken.
    Greeting - No Greeting is played (default)
    MusicOnHoldAudioFile - No custom MusicOnHold is played (UseDefaultMusicOnHold is used)
    OverflowSharedVoicemailAudioFile - SharedVoicemail will not be configured
    TimeoutSharedVoicemailAudioFile - SharedVoicemail will not be configured
  .COMPONENT
    TeamsCallQueue
  .FUNCTIONALITY
    Creates a Call Queue with custom settings and friendly names as input
  .LINK
    https://github.com/DEberhardt/TeamsFunctions/tree/main/docs/New-TeamsCallQueue.md
  .LINK
    https://github.com/DEberhardt/TeamsFunctions/tree/main/docs/about_TeamsCallQueue.md
  .LINK
    https://github.com/DEberhardt/TeamsFunctions/tree/main/docs/
  #>

  [CmdletBinding(SupportsShouldProcess, ConfirmImpact = 'Medium', PositionalBinding = $false)]
  [Alias('New-TeamsCQ')]
  [OutputType([System.Object])]
  param(
    [Parameter(Mandatory, Position = 0, HelpMessage = 'Name of the Call Queue')]
    [string]$Name,

    [Parameter(HelpMessage = 'Will adhere to defaults as Microsoft outlines in New-CsCallQueue')]
    [switch]$UseMicrosoftDefaults,

    [Parameter(HelpMessage = 'Time an agent is alerted in seconds (15-180s)')]
    [ValidateScript( {
        If ($_ -ge 15 -and $_ -le 180) { $True } else {
          throw [System.Management.Automation.ValidationMetadataException] 'Must be a value between 30 and 180s (3 minutes)'
        } })]
    [int16]$AgentAlertTime,

    [Parameter(HelpMessage = 'Can agents opt in or opt out from taking calls from a Call Queue (Default: TRUE)')]
    [boolean]$AllowOptOut,

    #region Overflow Params
    [Parameter(HelpMessage = 'Action to be taken for Overflow')]
    [Validateset('DisconnectWithBusy', 'Forward', 'Voicemail', 'SharedVoicemail')]
    [Alias('OA')]
    [string]$OverflowAction = 'DisconnectWithBusy',

    # if OverflowAction is not DisconnectWithBusy, this is required
    [Parameter(HelpMessage = 'TEL URI or UPN that is targeted upon overflow, only valid for forwarded calls')]
    [Alias('OAT')]
    [string]$OverflowActionTarget,

    #region OverflowAction = SharedVoiceMail
    # if OverflowAction is SharedVoicemail one of the following two have to be provided
    [Parameter(HelpMessage = 'Text-to-Voice Message. This will require the LanguageId Parameter')]
    [Alias('OfSVmTTS')]
    [string]$OverflowSharedVoicemailTextToSpeechPrompt,

    [Parameter(HelpMessage = 'Path to Audio File for the SharedVoiceMail Message')]
    [Alias('OfVMFile')]
    [ArgumentCompleter( { 'C:\Temp\' })]
    [string]$OverflowSharedVoicemailAudioFile,

    [Parameter(HelpMessage = 'Using this Parameter will make a Transcription of the Voicemail message available in the Mailbox')]
    [Alias('TranscribeOfVm')]
    [bool]$EnableOverflowSharedVoicemailTranscription,
    #endregion

    #Deviation from MS Default (50)
    [Parameter(HelpMessage = 'Time in seconds (0-200s) before timeout action is triggered (Default: 10, Note: Microsoft default: 50)')]
    [Alias('OfThreshold', 'OfQueueLength')]
    [ValidateScript( {
        If ($_ -ge 0 -and $_ -le 200) { $True } else {
          throw [System.Management.Automation.ValidationMetadataException] 'OverflowThreshold: Must be a value between 0 and 200s.'
        } })]
    [int16]$OverflowThreshold,
    #endregion

    #region Timeout Params
    [Parameter(HelpMessage = 'Action to be taken for Timeout')]
    [Validateset('Disconnect', 'Forward', 'Voicemail', 'SharedVoicemail')]
    [Alias('TA')]
    [string]$TimeoutAction = 'Disconnect',

    # if TimeoutAction is not Disconnect, this is required
    [Parameter(HelpMessage = 'TEL URI or UPN that is targeted upon timeout, only valid for forwarded calls')]
    [Alias('TAT')]
    [string]$TimeoutActionTarget,

    #region TimeoutAction = SharedVoiceMail
    # if TimeoutAction is SharedVoicemail one of the following two have to be provided
    [Parameter(HelpMessage = 'Text-to-Voice Message. This will require the LanguageId Parameter')]
    [Alias('ToSVmTTS')]
    [string]$TimeoutSharedVoicemailTextToSpeechPrompt,

    [Parameter(HelpMessage = 'Path to Audio File for the SharedVoiceMail Message')]
    [Alias('ToVMFile')]
    [ArgumentCompleter( { 'C:\Temp\' })]
    [string]$TimeoutSharedVoicemailAudioFile,

    [Parameter(HelpMessage = 'Using this Parameter will make a Transcription of the Voicemail message available in the Mailbox')]
    [Alias('TranscribeToVm')]
    [bool]$EnableTimeoutSharedVoicemailTranscription,
    #endregion

    #Deviation from MS Default (1200s)
    [Parameter(HelpMessage = 'Time in seconds (0-2700s) before timeout action is triggered (Default: 30, Note: Microsoft default: 1200)')]
    [Alias('ToThreshold')]
    [ValidateScript( {
        If ($_ -ge 0 -and $_ -le 2700) { $True }else {
          throw [System.Management.Automation.ValidationMetadataException] 'TimeoutThreshold: Must be a value between 0 and 2700s, will be rounded to nearest 15s intervall (0/15/30/45)'
        } })]
    [int16]$TimeoutThreshold,
    #endregion

    [Parameter(HelpMessage = 'Method to alert Agents')]
    [Validateset('Attendant', 'Serial', 'RoundRobin', 'LongestIdle')]
    [string]$RoutingMethod = 'Attendant',

    [Parameter(HelpMessage = 'If used, Agents receive calls only when their presence state is Available')]
    [boolean]$PresenceBasedRouting,

    [Parameter(HelpMessage = 'Indicates whether the default Music On Hold is used')]
    [boolean]$UseDefaultMusicOnHold,

    [Parameter(HelpMessage = 'If used, Conference mode is used to establish calls')]
    [boolean]$ConferenceMode,

    #region Music files
    [Parameter(HelpMessage = 'Path to Audio File for Welcome Message')]
    [Alias('WelcomeMessage', 'WelcomeTextToSpeechPrompt', 'WelcomeMusicAudioFile')]
    [AllowNull()]
    [ArgumentCompleter( { '<Your Text-to-speech-string>', 'C:\Temp\' })]
    [string]$Greeting,

    [Parameter(HelpMessage = 'Path to Audio File for MusicOnHold (cannot be used with UseDefaultMusicOnHold switch!)')]
    [AllowNull()]
    [ArgumentCompleter( { 'C:\Temp\' })]
    [string]$MusicOnHoldAudioFile,
    #endregion

    #region Agents
    [Parameter(HelpMessage = 'Name of one or more Distribution Lists')]
    [string[]]$DistributionLists,

    [Parameter(HelpMessage = 'UPN of one or more Users')]
    [ValidateScript( {
        If ($_ -match '@' -or $_ -match $script:TFMatchGuid) { $True } else {
          throw [System.Management.Automation.ValidationMetadataException] 'Value must be a valid UPN or ObjectId'
        } })]
    [string[]]$Users,

    [Parameter(HelpMessage = 'UPN of one or more Resource Accounts used for Caller Id')]
    [ValidateScript( {
        If ($_ -match '@' -or $_ -match $script:TFMatchGuid) { $True } else {
          throw [System.Management.Automation.ValidationMetadataException] 'Value must be a valid UPN or ObjectId'
        } })]
    [string[]]$ResourceAccountsForCallerId,

    [Parameter(HelpMessage = 'UPN of one Owner of the Channel')]
    [ValidateScript( {
        If ($_ -match '@' -or $_ -match $script:TFMatchGuid) { $True } else {
          throw [System.Management.Automation.ValidationMetadataException] 'Value must be a valid UPN or ObjectId'
        } })]
    [string]$ChannelOwner,

    [Parameter(HelpMessage = "Team and Channel in the format 'Team\Channel'")]
    [ValidateScript( { $_ -match '\\' })]
    [string]$TeamAndChannel,
    #endregion

    [Parameter(HelpMessage = 'Language Identifier from Get-CsAutoAttendantSupportedLanguage.')]
    [ValidateScript( {
        if ($_ -in $(&$global:TfAcSbSupportedLanguage).Id ) { $True } else {
          throw [System.Management.Automation.ValidationMetadataException] 'Value must be a supported Langauge Id. Use Intellisense for options'
        } })]
    [ArgumentCompleter({ $(&$global:TfAcSbSupportedLanguage).Id })]
    [string]$LanguageId,

    [Parameter(HelpMessage = 'UPN of one or more Users')]
    [ValidateScript( {
        If ($_ -match '@' -or $_ -match $script:TFMatchGuid) { $True } else {
          throw [System.Management.Automation.ValidationMetadataException] 'Value must be a valid UPN or ObjectId'
        } })]
    [string[]]$AuthorizedUsers

  ) #param

  begin {
    Show-FunctionStatus -Level Live
    Write-Verbose -Message "[BEGIN ] $($MyInvocation.MyCommand)"

    # Asserting AzureAD Connection
    if ( -not $script:TFPSSA) { $script:TFPSSA = Assert-AzureADConnection; if ( -not $script:TFPSSA ) { break } }

    # Asserting MicrosoftTeams Connection
    if ( -not (Assert-MicrosoftTeamsConnection) ) { break }

    # Setting Preference Variables according to Upstream settings
    if (-not $PSBoundParameters.ContainsKey('Verbose')) { $VerbosePreference = $PSCmdlet.SessionState.PSVariable.GetValue('VerbosePreference') }
    if (-not $PSBoundParameters.ContainsKey('Confirm')) { $ConfirmPreference = $PSCmdlet.SessionState.PSVariable.GetValue('ConfirmPreference') }
    if (-not $PSBoundParameters.ContainsKey('WhatIf')) { $WhatIfPreference = $PSCmdlet.SessionState.PSVariable.GetValue('WhatIfPreference') }
    if (-not $PSBoundParameters.ContainsKey('Debug')) { $DebugPreference = $PSCmdlet.SessionState.PSVariable.GetValue('DebugPreference') } else { $DebugPreference = 'Continue' }
    if ( $PSBoundParameters.ContainsKey('InformationAction')) { $InformationPreference = $PSCmdlet.SessionState.PSVariable.GetValue('InformationAction') } else { $InformationPreference = 'Continue' }

    #Initialising Counters
    $private:StepsID0, $private:StepsID1 = Get-WriteBetterProgressSteps -Code $($MyInvocation.MyCommand.Definition) -MaxId 1
    $private:ActivityID0 = $($MyInvocation.MyCommand.Name)
    [int] $private:CountID0 = [int] $private:CountID1 = 1

    #region Validating Input
    $StatusID0 = 'Validating Input'
    $CurrentOperationID0 = 'LanguageId'
    Write-BetterProgress -Id 0 -Activity $ActivityID0 -Status $StatusID0 -CurrentOperation $CurrentOperationID0 -Step ($private:CountID0++) -Of $private:StepsID0
    # Language has to be normalised as the Id is case sensitive
    if ($PSBoundParameters.ContainsKey('LanguageId')) {
      $Language = $($LanguageId.Split('-')[0]).ToLower() + '-' + $($LanguageId.Split('-')[1]).ToUpper()
      Write-Verbose "LanguageId '$LanguageId' normalised to '$Language'"
      if ((Get-CsAutoAttendantSupportedLanguage -Id $Language).VoiceResponseSupported) {
        Write-Verbose -Message "LanguageId '$Language' - Voice Responses supported"
      }
      else {
        Write-Verbose -Message "LanguageId '$Language' - Voice Responses not supported"
      }
    }
    else {
      # Checking for Parameters which would require LanguageId
      if (($PSBoundParameters.ContainsKey('OverflowSharedVoicemailTextToSpeechPrompt')) -or `
        ($PSBoundParameters.ContainsKey('TimeoutSharedVoicemailTextToSpeechPrompt')) -or `
        (($PSBoundParameters.ContainsKey('EnableOverflowSharedVoicemailTranscription') -and $EnableOverflowSharedVoicemailTranscription)) -or `
        (($PSBoundParameters.ContainsKey('EnableTimeoutSharedVoicemailTranscription') -and $EnableTimeoutSharedVoicemailTranscription))) {

        Write-Error 'Parameter LanguageId is required and missing. Text-to-Voice prompts or Transcription require specification of a Language. No default is available.' -ErrorAction Stop -RecommendedAction 'Add Parameter LanguageId'
        return
      }
    }

    # Mutual exclusivity of Channel and Users/Groups
    $CurrentOperationID0 = 'Checking for mutual exclusivity of Channel and Users/Groups'
    Write-BetterProgress -Id 0 -Activity $ActivityID0 -Status $StatusID0 -CurrentOperation $CurrentOperationID0 -Step ($private:CountID0++) -Of $private:StepsID0
    if ($PSBoundParameters.ContainsKey('TeamAndChannel') -and ($PSBoundParameters.ContainsKey('Users') -or $PSBoundParameters.ContainsKey('DistributionLists'))) {
      Write-Warning "Parameter 'TeamAndChannel' cannot be combined with Users or Groups. It will be ignored!"
      [void]$PSBoundParameters.Remove('TeamAndChannel')
    }

    #endregion
  } #begin

  process {
    Write-Verbose -Message "[PROCESS] $($MyInvocation.MyCommand)"
    #region PREPARATION
    $StatusID0 = 'Processing Name, Audio Files & Queue Options'
    # preparing Splatting Object
    $Parameters = $null

    #region Required Parameters: Name
    $CurrentOperationID0 = 'DisplayName'
    Write-BetterProgress -Id 0 -Activity $ActivityID0 -Status $StatusID0 -CurrentOperation $CurrentOperationID0 -Step ($private:CountID0++) -Of $private:StepsID0
    $NameNormalised = Format-StringForUse -InputString $Name -As DisplayName
    Write-Information "INFO: Call Queue '$Name' DisplayName normalised to: '$NameNormalised'"
    $Parameters += @{'Name' = $NameNormalised }
    #endregion

    #region Music On Hold
    $CurrentOperationID0 = 'Music On Hold Audio File'
    Write-BetterProgress -Id 0 -Activity $ActivityID0 -Status $StatusID0 -CurrentOperation $CurrentOperationID0 -Step ($private:CountID0++) -Of $private:StepsID0
    if ($PSBoundParameters.ContainsKey('MusicOnHoldAudioFile') -and $PSBoundParameters.ContainsKey('UseDefaultMusicOnHold')) {
      Write-Warning -Message "'$NameNormalised' MusicOnHoldAudioFile and UseDefaultMusicOnHold are mutually exclusive. UseDefaultMusicOnHold is ignored!"
      $UseDefaultMusicOnHold = $false
    }
    if ($PSBoundParameters.ContainsKey('MusicOnHoldAudioFile')) {
      if ($null -ne $MusicOnHoldAudioFile) {
        # File import handles file existence, format & size requirements
        $MOHFileName = Split-Path $MusicOnHoldAudioFile -Leaf
        Write-Verbose -Message "'$NameNormalised' MusicOnHoldAudioFile: Parsing: '$MOHFileName'"
        try {
          $MOHFile = Import-TeamsAudioFile -ApplicationType CallQueue -File "$MusicOnHoldAudioFile" -ErrorAction STOP
          Write-Information "INFO: Call Queue '$NameNormalised' MusicOnHoldAudioFile: Using: '$($MOHFile.FileName)'"
          $Parameters += @{'MusicOnHoldAudioFileId' = $MOHFile.Id }
        }
        catch {
          #Write-Error -Message "Import of MusicOnHoldAudioFile: '$MOHFileName' failed." -Category InvalidData -RecommendedAction "Please check file size and compression ratio. If in doubt, provide WAV"
          Write-Warning -Message "Import of MusicOnHoldAudioFile: '$MOHFileName' failed. Please check file size and compression ratio. If in doubt, provide WAV"
          Write-Verbose -Message "'$NameNormalised' MusicOnHoldAudioFile: Using: DEFAULT" -Verbose
          $UseDefaultMusicOnHold = $true
          $Parameters += @{'UseDefaultMusicOnHold' = $true }
        }
      }
      else {
        Write-Verbose -Message "'$NameNormalised' MusicOnHoldAudioFile: Using: DEFAULT"
      }
    }
    else {
      Write-Verbose -Message "'$NameNormalised' MusicOnHoldAudioFile: Using: DEFAULT"
      $UseDefaultMusicOnHold = $true
      $Parameters += @{'UseDefaultMusicOnHold' = $true }
    }
    #endregion

    #region Welcome Message
    $CurrentOperationID0 = 'Welcome Message Audio File'
    Write-BetterProgress -Id 0 -Activity $ActivityID0 -Status $StatusID0 -CurrentOperation $CurrentOperationID0 -Step ($private:CountID0++) -Of $private:StepsID0
    if ($PSBoundParameters.ContainsKey('Greeting')) {
      #TEST This may come available v4.8 or v4.9 and needs retesting then.
      if ($null -ne $Greeting) {
        if ($Greeting -match '.(wav|wma|mp3)$') {
          # Recording - File import handles file existence, format & size requirements
          $WMFileName = Split-Path $Greeting -Leaf
          Write-Verbose -Message "'$NameNormalised' Greeting: Parsing: '$WMFileName'"
          try {
            $WMFile = Import-TeamsAudioFile -ApplicationType CallQueue -File "$Greeting" -ErrorAction STOP
            Write-Information "INFO: Call Queue '$NameNormalised' Greeting: Using: '$($WMFile.FileName)'"
            $Parameters += @{'WelcomeMusicAudioFileId' = $WMFile.Id }
          }
          catch {
            Write-Error -Message "Import of Greeting: '$WMFileName' failed. Please check file size and compression ratio. If in doubt, provide WAV" -Category InvalidData -RecommendedAction 'Please check file size and compression ratio. If in doubt, provide WAV'
            Write-Verbose -Message "'$NameNormalised' Greeting: Using: NONE or EXISTING"
          }
        }
        else {
          # Text-To-Voice is assumed if String does not end with a supported file extension
          <#
          #TEST This may not even be needed as AutoAttendant Prompt and SharedVoicemail prompt accept empty strings!
          switch ( $Greeting.length ) {
            { $_ -ge 10 -and $_ -le 1000 } {
              Write-Information "'$NameNormalised' Greeting: Message length OK. Using String as-is"
              $Greeting = if ( $Greeting.Trim().length -gt 10) { $Greeting.Trim() } else { $Greeting }
            }
            { $_ -lt 10 } {
              $Greeting = $Greeting + $(' ' * (10 - $Greeting.Length))
              Write-Warning -Message "'$NameNormalised' Greeting: Message too short, adding spaces at the end (this will be interpreted as a pause)."
            }
            { $_ -gt 1000 } {
              $Greeting = $Greeting.Trim().Substring(0, 999)
              Write-Warning -Message "'$NameNormalised' Greeting: Message too long, cutting string at 1000 characters. Please validate:"
            }
          }
          #>
          if ( $Greeting.length -gt 1000 ) {
            $Greeting = $Greeting.Trim().Substring(0, 999)
            Write-Warning -Message "'$NameNormalised' Greeting: Message too long, cutting string at 1000 characters. Please validate!"
          }
          Write-Information "'$NameNormalised' Greeting: Using String as Text-to-Voice Prompt: '$Greeting'"
          if ( $(Get-Command New-CsCallQueue -ParameterName WelcomeTextToSpeechPrompt -ErrorAction Ignore) ) {
            $Parameters += @{'WelcomeTextToSpeechPrompt' = "$($Greeting.Trim())" }
          }
          else {
            Write-Warning -Message "Parameter 'WelcomeTextToSpeechPrompt' is not yet present. This parameter is introduced in MicrosoftTeams v4.9.2. Please Update Module MicrosoftTeams or use the Admin Center to provision a Text-To-Voice Greeting!"
          }
        }
      }
      else {
        Write-Verbose -Message "'$NameNormalised' Greeting: Using: NONE"
      }
    }
    else {
      Write-Verbose -Message "'$NameNormalised' Greeting: Using: NONE"
    }
    #endregion

    #region Routing metrics, Thresholds and Language
    # One Progress operation for all Parameters
    $CurrentOperationID0 = 'Routing metrics, Thresholds and Language'
    Write-BetterProgress -Id 0 -Activity $ActivityID0 -Status $StatusID0 -CurrentOperation $CurrentOperationID0 -Step ($private:CountID0++) -Of $private:StepsID0

    #region ValueSet Parameters
    # RoutingMethod
    if ($PSBoundParameters.ContainsKey('RoutingMethod')) {
      $Parameters += @{'RoutingMethod' = $RoutingMethod }
    }
    #endregion

    #region Boolean Parameters
    # PresenceBasedRouting
    if ($PSBoundParameters.ContainsKey('PresenceBasedRouting')) {
      if ($PresenceBasedRouting) {
        $Parameters += @{'PresenceBasedRouting' = $true }
      }
      else {
        $Parameters += @{'PresenceBasedRouting' = $false }
      }
    }
    # AllowOptOut
    if ($PSBoundParameters.ContainsKey('AllowOptOut')) {
      if ($AllowOptOut) {
        $Parameters += @{'AllowOptOut' = $true }
      }
      else {
        $Parameters += @{'AllowOptOut' = $false }
      }
    }
    # ConferenceMode
    if ($PSBoundParameters.ContainsKey('ConferenceMode')) {
      if ($ConferenceMode) {
        $Parameters += @{'ConferenceMode' = $true }
      }
      else {
        $Parameters += @{'ConferenceMode' = $false }
      }
    }
    #endregion

    #region Valued Parameters
    # AgentAlertTime
    if ($PSBoundParameters.ContainsKey('AgentAlertTime')) {
      Write-Information "INFO: Call Queue '$NameNormalised' AgentAlertTime: $AgentAlertTime"
      $Parameters += @{'AgentAlertTime' = $AgentAlertTime }
    }

    # Optimized and MicrosoftDefaults for Thresholds
    if ($PSBoundParameters.ContainsKey('UseMicrosoftDefaults')) {
      Write-Verbose -Message "'$NameNormalised' Setting default values according to New-CsCallQueue (Microsoft defaults)" -Verbose
      # OverflowThreshold
      if ($PSBoundParameters.ContainsKey('OverflowThreshold')) {
        Write-Verbose -Message "'$NameNormalised' OverflowThreshold: $OverflowThreshold" -Verbose
        $Parameters += @{'OverflowThreshold' = $OverflowThreshold }
      }
      # TimeoutThreshold
      if ($PSBoundParameters.ContainsKey('TimeoutThreshold')) {
        Write-Verbose -Message "'$NameNormalised' TimeoutThreshold: $TimeoutThreshold" -Verbose
        $Parameters += @{'TimeoutThreshold' = $TimeoutThreshold }
      }
    }
    else {
      Write-Verbose -Message "'$NameNormalised' Setting default values according to New-TeamsCallQueue (optimised defaults)" -Verbose
      # OverflowThreshold
      if (-not $PSBoundParameters.ContainsKey('OverflowThreshold')) {
        $OverflowThreshold = 10
      }
      Write-Verbose -Message "'$NameNormalised' OverflowThreshold: $OverflowThreshold" -Verbose
      $Parameters += @{'OverflowThreshold' = $OverflowThreshold }

      # TimeoutThreshold
      if (-not $PSBoundParameters.ContainsKey('TimeoutThreshold')) {
        $TimeoutThreshold = 30
      }
      Write-Verbose -Message "'$NameNormalised' TimeoutThreshold: $TimeoutThreshold" -Verbose
      $Parameters += @{'TimeoutThreshold' = $TimeoutThreshold }
    }
    #endregion

    #region Language
    if ($PSBoundParameters.ContainsKey('LanguageId')) {
      $Parameters += @{'LanguageId' = $Language }
    }

    # Checking for Text-to-Voice prompts without providing LanguageId
    # This is already done in the BEGIN block
    #endregion
    #endregion
    #endregion


    #region Overflow
    $StatusID0 = 'Processing Overflow Parameters'
    #region Overflow Action
    $CurrentOperationID0 = 'OverflowAction'
    Write-BetterProgress -Id 0 -Activity $ActivityID0 -Status $StatusID0 -CurrentOperation $CurrentOperationID0 -Step ($private:CountID0++) -Of $private:StepsID0
    if ($PSBoundParameters.ContainsKey('OverflowAction')) {
      Write-Verbose -Message "'$NameNormalised' OverflowAction '$OverflowAction' Parsing requirements"
      if ($PSBoundParameters.ContainsKey('OverflowActionTarget')) {
        # We have a Target
        if ($OverflowAction -eq 'DisconnectWithBusy') {
          #but we don't need one
          Write-Verbose -Message "'$NameNormalised' OverflowAction '$OverflowAction' does not require an OverflowActionTarget. It will not be processed" -Verbose
        }
        else {
          # OK
          Write-Verbose -Message "'$NameNormalised' OverflowAction '$OverflowAction' and OverflowActionTarget '$OverflowActionTarget' specified. Processing both."
        }
        # NEW: Adding Action only with a Target | SET: Adding Action if specified
        $Parameters += @{'OverflowAction' = $OverflowAction }
      }
      elseif ($OverflowAction -ne 'DisconnectWithBusy') {
        Write-Warning -Message "'$NameNormalised' OverflowAction '$OverflowAction' not set! Parameter OverflowActionTarget missing OverflowAction will not be set"
      }
    }
    else {
      $OverflowAction = 'DisconnectWithBusy'
      Write-Verbose -Message "'$NameNormalised' Parameter OverflowAction not present. Using existing setting: '$OverflowAction'"
    }
    #endregion

    #region OverflowActionTarget
    # Processing for Target is dependent on Action
    $CurrentOperationID0 = 'OverflowActionTarget'
    Write-BetterProgress -Id 0 -Activity $ActivityID0 -Status $StatusID0 -CurrentOperation $CurrentOperationID0 -Step ($private:CountID0++) -Of $private:StepsID0
    if ($PSBoundParameters.ContainsKey('OverflowActionTarget')) {
      Write-Verbose -Message "'$NameNormalised' Parsing OverflowActionTarget" -Verbose
      try {
        switch ($OverflowAction) {
          'DisconnectWithBusy' {
            # Explicit setting of DisconnectWithBusy
            if (-not $PSBoundParameters.ContainsKey('OverflowAction')) {
              Write-Verbose -Message "'$NameNormalised' OverflowAction '$OverflowAction': No Overflow-Parameters are processed" -Verbose
            }
            #else: No Action
          }
          'Forward' {
            # Forward requires an OverflowActionTarget (Tel URI, ObjectId of UPN of a User or an Application Instance to be translated to GUID)
            $Target = $OverflowActionTarget
            $CallTarget = $null
            $CallTarget = Get-TeamsCallableEntity -Identity "$Target"
            switch ( $CallTarget.ObjectType ) {
              'TelURI' {
                #Telephone Number (E.164)
                $Parameters += @{'OverflowActionTarget' = $CallTarget.Identity }
              }
              'User' {
                try {
                  $Assertion = $null
                  $Assertion = Assert-TeamsCallableEntity -UserPrincipalName "$($CallTarget.Entity)" -RequireEV -WarningAction SilentlyContinue -ErrorAction Stop
                  if ($Assertion) {
                    $Parameters += @{'OverflowActionTarget' = $CallTarget.Identity }
                  }
                  else {
                    Write-Warning -Message "'$NameNormalised' OverflowAction '$OverflowAction': OverflowActionTarget '$OverflowActionTarget' not asserted"
                  }
                }
                catch {
                  Write-Warning -Message "'$NameNormalised' OverflowAction '$OverflowAction': OverflowActionTarget '$OverflowActionTarget' Error: $($_.Exception.Message)"
                }
              }
              'ResourceAccount' {
                try {
                  $Assertion = $null
                  $Assertion = Assert-TeamsCallableEntity -UserPrincipalName "$($CallTarget.Entity)" -WarningAction SilentlyContinue -ErrorAction Stop
                  if ($Assertion) {
                    $Parameters += @{'OverflowActionTarget' = $CallTarget.Identity }
                  }
                  else {
                    Write-Warning -Message "'$NameNormalised' OverflowAction '$OverflowAction': OverflowActionTarget '$OverflowActionTarget' not asserted"
                  }
                }
                catch {
                  Write-Warning -Message "'$NameNormalised' OverflowAction '$OverflowAction': OverflowActionTarget '$OverflowActionTarget' Error: $($_.Exception.Message)"
                }
              }
              default {
                # Capturing any other specified Target that does not match for the Forward
                Write-Warning -Message "'$NameNormalised' OverflowAction '$OverflowAction': OverflowActionTarget '$OverflowActionTarget' is incompatible and is not processed!"
                Write-Verbose -Message "'$NameNormalised' OverflowAction '$OverflowAction': OverflowActionTarget expected is: Tel URI or a UPN of a User or Resource Account" -Verbose
              }
            }
          }
          'VoiceMail' {
            # VoiceMail requires an OverflowActionTarget (UPN of a User to be translated to GUID)
            $Target = $OverflowActionTarget
            $CallTarget = Get-TeamsCallableEntity -Identity "$Target"
            if ($CallTarget.ObjectType -eq 'User') {
              try {
                $Assertion = $null
                $Assertion = Assert-TeamsCallableEntity -UserPrincipalName "$($CallTarget.Entity)" -RequireEV -WarningAction SilentlyContinue -ErrorAction Stop
                if ($Assertion) {
                  $Parameters += @{'OverflowActionTarget' = $CallTarget.Identity }
                }
                else {
                  Write-Warning -Message "'$NameNormalised' OverflowAction '$OverflowAction': OverflowActionTarget '$OverflowActionTarget' not asserted"
                }
              }
              catch {
                Write-Warning -Message "'$NameNormalised' OverflowAction '$OverflowAction': OverflowActionTarget '$OverflowActionTarget' Error: $($_.Exception.Message)"
              }
            }
            else {
              Write-Warning -Message "'$NameNormalised' OverflowAction '$OverflowAction': OverflowActionTarget '$OverflowActionTarget' is incompatible and is not processed!"
              Write-Verbose -Message "'$NameNormalised' OverflowAction '$OverflowAction': OverflowActionTarget expected is: UPN of a User" -Verbose
            }
          }
          'SharedVoiceMail' {
            # SharedVoiceMail requires an OverflowActionTarget (UPN of a Group to be translated to GUID)
            #region SharedVoiceMail prerequisites
            if ($PSBoundParameters.ContainsKey('OverflowSharedVoicemailAudioFile') -and $PSBoundParameters.ContainsKey('OverflowSharedVoicemailTextToSpeechPrompt')) {
              # Both Parameters provided
              Write-Verbose -Message "'$NameNormalised' OverflowAction '$OverflowAction': OverflowSharedVoicemailAudioFile and OverflowSharedVoicemailTextToSpeechPrompt are mutually exclusive. Processing File only" -Verbose
              [void]$PSBoundParameters.Remove('OverflowSharedVoicemailTextToSpeechPrompt')
            }
            elseif (-not $PSBoundParameters.ContainsKey('OverflowSharedVoicemailAudioFile') -and -not $PSBoundParameters.ContainsKey('OverflowSharedVoicemailTextToSpeechPrompt')) {
              # Neither Parameter provided
              Write-Error -Message "'$NameNormalised' OverflowAction '$OverflowAction': Parameter OverflowSharedVoicemailAudioFile or OverflowSharedVoicemailTextToSpeechPrompt missing" -ErrorAction Stop -RecommendedAction 'Add one of the two parameters'
              return
            }
            elseif ($PSBoundParameters.ContainsKey('OverflowSharedVoicemailTextToSpeechPrompt')) {
              if (-not $PSBoundParameters.ContainsKey('LanguageId')) {
                Write-Error -Message "'$NameNormalised' OverflowAction '$OverflowAction': OverflowSharedVoicemailTextToSpeechPrompt requires Language selection. Please provide Parameter LanguageId" -ErrorAction Stop -RecommendedAction 'Add Parameter LanguageId'
                return
              }
              else {
                Write-Verbose -Message "'$NameNormalised' OverflowAction '$OverflowAction': OverflowSharedVoicemailTextToSpeechPrompt: Language '$Language' is used" -Verbose
              }
            }
            elseif ($PSBoundParameters.ContainsKey('OverflowSharedVoicemailAudioFile')) {
              # Asserting provided Audio File
              if ( -not (Assert-TeamsAudioFile "$OverflowSharedVoicemailAudioFile")) {
                Write-Warning -Message 'OverflowSharedVoicemailAudioFile: AudioFile could not be imported. Please validate!'
                [void]$PSBoundParameters.Remove('OverflowSharedVoicemailAudioFile')
              }
            }
            #endregion

            #region OverflowAction SharedVoicemail - Processing Parameters
            # For NEW, we process all under the condition that OverflowAction is set.
            # For SET, we process them separately, but dependent on the current status of OverflowAction or provided parameter
            # Affected parameters: OverflowActionTarget, OverflowSharedVoicemailAudioFile, OverflowSharedVoicemailTextToSpeechPrompt & EnableOverflowSharedVoicemailTranscription

            if (-not $PSBoundParameters.ContainsKey('OverflowSharedVoicemailAudioFile') -and -not $PSBoundParameters.ContainsKey('OverflowSharedVoicemailTextToSpeechPrompt')) {
              # Not processing SharedVoicemail parameters if - after validation - neither AudioFile nor Text-to-Voice are present
              Write-Warning -Message "'$NameNormalised' OverflowAction '$OverflowAction': Parameter OverflowSharedVoicemailAudioFile or OverflowSharedVoicemailTextToSpeechPrompt missing"
              #Write-Error -Message "'$NameNormalised' OverflowAction '$OverflowAction': Parameter OverflowSharedVoicemailAudioFile or OverflowSharedVoicemailTextToSpeechPrompt missing" -ErrorAction Stop -RecommendedAction 'Add one of the two parameters'
              #return
            }
            else {
              #region OverflowAction SharedVoicemail - Processing OverflowActionTarget
              Write-Verbose -Message "'$NameNormalised' OverflowAction '$OverflowAction': OverflowActionTarget '$OverflowActionTarget' - Querying Object"
              $CallTarget = $null
              $CallTarget = Get-TeamsCallableEntity -Identity "$OverflowActionTarget"
              switch ( $CallTarget.ObjectType ) {
                'Group' {
                  $OverflowActionTargetId = $CallTarget.Identity
                  Write-Verbose -Message "'$NameNormalised' OverflowAction '$OverflowAction': OverflowActionTarget '$OverflowActionTarget' - Object found!"
                  $Parameters += @{'OverflowActionTarget' = $OverflowActionTargetId }
                }
                'Unknown' {
                  Write-Warning -Message "'$NameNormalised' OverflowAction '$OverflowAction': OverflowActionTarget '$OverflowActionTarget' not set! Error enumerating Target"
                  if ($PSBoundParameters.ContainsKey('Debug') -or $DebugPreference -eq 'Continue') {
                    " Function: $($MyInvocation.MyCommand.Name) - CallTarget:", ($CallTarget | Format-Table -AutoSize | Out-String).Trim() | Write-Debug
                  }
                }
                default {
                  Write-Warning -Message "'$NameNormalised' OverflowAction '$OverflowAction': OverflowActionTarget '$OverflowActionTarget' not a Group!"
                }
              }
              #endregion

              #region OverflowAction SharedVoicemail - Processing OverflowSharedVoicemailAudioFile
              if ($PSBoundParameters.ContainsKey('OverflowSharedVoicemailAudioFile')) {
                if ($OverflowAction -ne 'SharedVoicemail') {
                  Write-Verbose -Message "'$NameNormalised' OverflowSharedVoicemailAudioFile: Not processing Parameter as it is not valid for OverflowAction '$OverflowAction'" -Verbose
                }
                else {
                  $OfSVmFileName = Split-Path $OverflowSharedVoicemailAudioFile -Leaf
                  Write-Verbose -Message "'$NameNormalised' OverflowSharedVoicemailAudioFile: Parsing: '$OfSVmFileName'"
                  try {
                    $OfSVmFile = Import-TeamsAudioFile -ApplicationType CallQueue -File "$OverflowSharedVoicemailAudioFile" -ErrorAction STOP
                    Write-Information "INFO: Call Queue '$NameNormalised' OverflowSharedVoicemailAudioFile: Using: '$($OfSVmFile.FileName)'"
                    $Parameters += @{'OverflowSharedVoicemailAudioFilePrompt' = $OfSVmFile.Id }
                  }
                  catch {
                    Write-Error -Message "Import of OverflowSharedVoicemailAudioFile: '$OfSVmFileName' failed." -Category InvalidData -RecommendedAction 'Please check file size and compression ratio. If in doubt, provide WAV'
                    return
                  }
                }
              }
              #endregion

              #region OverflowAction SharedVoicemail - Processing OverflowSharedVoicemailTextToSpeechPrompt
              if ($PSBoundParameters.ContainsKey('OverflowSharedVoicemailTextToSpeechPrompt')) {
                if ($OverflowAction -ne 'SharedVoicemail') {
                  Write-Verbose -Message "'$NameNormalised' OverflowSharedVoicemailTextToSpeechPrompt: Not processing Parameter as it is not valid for OverflowAction '$OverflowAction'" -Verbose
                }
                else {
                  if ( $OverflowSharedVoicemailTextToSpeechPrompt.length -gt 1000 ) {
                    $OverflowSharedVoicemailTextToSpeechPrompt = $OverflowSharedVoicemailTextToSpeechPrompt.Trim().Substring(0, 999)
                    Write-Warning -Message 'OverflowSharedVoicemailTextToSpeechPrompt: Message too long, cutting string at 1000 characters. Please validate!'
                  }
                  $Parameters += @{'OverflowSharedVoicemailTextToSpeechPrompt' = "$OverflowSharedVoicemailTextToSpeechPrompt" }
                }
              }
              #endregion

              #region OverflowAction SharedVoicemail - Processing EnableOverflowSharedVoicemailTranscription
              if ($PSBoundParameters.ContainsKey('EnableOverflowSharedVoicemailTranscription')) {
                if ($OverflowAction -ne 'SharedVoicemail') {
                  Write-Verbose -Message "'$NameNormalised' EnableOverflowSharedVoicemailTranscription: Not processing Parameter as it is not valid for OverflowAction '$OverflowAction'" -Verbose
                }
                else {
                  $Parameters += @{'EnableOverflowSharedVoicemailTranscription' = $EnableOverflowSharedVoicemailTranscription }
                }
              }
              #endregion
            }
            #endregion
          }
        }
      }
      catch {
        Write-Warning -Message "'$NameNormalised' OverflowAction '$OverflowAction': OverflowActionTarget '$OverflowActionTarget' not set! Error enumerating Target: $($_.Exception.Message)"
      }
    }
    #endregion

    #region OverflowAction Parameter cleanup
    if ($Parameters.OverflowActionTarget -eq '') {
      [void]$Parameters.Remove('OverflowActionTarget')
    }
    if ($Parameters.ContainsKey('OverflowAction') -and (-not $Parameters.ContainsKey('OverflowActionTarget')) -and ($OverflowAction -ne 'DisconnectWithBusy')) {
      Write-Verbose -Message "'$NameNormalised' OverflowAction '$OverflowAction': Action not set as OverflowActionTarget was not correctly enumerated" -Verbose
      [void]$Parameters.Remove('OverflowAction')
    }
    else {
      if ($Parameters.ContainsKey('OverflowAction')) {
        Write-Information "INFO: Call Queue '$NameNormalised' OverflowAction used: '$OverflowAction'"
      }
    }
    # For NEW: We remove all SharedVoicemail Parameters if no Target is present
    # For SET: Parameters may be applied individually (no removal of SharedVoicemail parameters)
    if ( $Parameters.OverflowActionTarget) {
      Write-Information "INFO: Call Queue '$NameNormalised' OverflowActionTarget: '$OverflowActionTarget'"
    }
    else {
      [void]$Parameters.Remove('OverflowSharedVoicemailTextToSpeechPrompt')
      [void]$Parameters.Remove('OverflowSharedVoicemailAudioFile')
      [void]$Parameters.Remove('EnableOverflowSharedVoicemailTranscription')
    }
    #endregion
    #endregion

    #region Timeout
    $StatusID0 = 'Processing Timeout Parameters'
    #region TimeoutAction
    $CurrentOperationID0 = 'TimeoutAction'
    Write-BetterProgress -Id 0 -Activity $ActivityID0 -Status $StatusID0 -CurrentOperation $CurrentOperationID0 -Step ($private:CountID0++) -Of $private:StepsID0
    if ($PSBoundParameters.ContainsKey('TimeoutAction')) {
      Write-Verbose -Message "'$NameNormalised' TimeoutAction '$TimeoutAction' Parsing requirements"
      if ($PSBoundParameters.ContainsKey('TimeoutActionTarget')) {
        # We have a Target
        if ($TimeoutAction -eq 'Disconnect') {
          #but we don't need one
          Write-Verbose -Message "'$NameNormalised' TimeoutAction '$TimeoutAction' does not require an TimeoutActionTarget. It will not be processed" -Verbose
        }
        else {
          # OK
          Write-Verbose -Message "'$NameNormalised' TimeoutAction '$TimeoutAction' and TimeoutActionTarget '$TimeoutActionTarget' specified. Processing both."
        }
        # NEW: Adding Action only with a Target | SET: Adding Action if specified
        $Parameters += @{'TimeoutAction' = $TimeoutAction }
      }
      elseif ($TimeoutAction -ne 'Disconnect') {
        Write-Warning -Message "'$NameNormalised' TimeoutAction '$TimeoutAction' not set! Parameter TimeoutActionTarget missing"
      }
    }
    else {
      $TimeoutAction = 'Disconnect'
      Write-Verbose -Message "'$NameNormalised' Parameter TimeoutAction not present. Using existing setting: '$TimeoutAction'"
    }
    #endregion

    #region TimeoutActionTarget
    # Processing for Target is dependent on Action
    $CurrentOperationID0 = 'TimeoutActionTarget'
    Write-BetterProgress -Id 0 -Activity $ActivityID0 -Status $StatusID0 -CurrentOperation $CurrentOperationID0 -Step ($private:CountID0++) -Of $private:StepsID0
    if ($PSBoundParameters.ContainsKey('TimeoutActionTarget')) {
      Write-Verbose -Message "'$NameNormalised' Parsing TimeoutActionTarget" -Verbose
      try {
        switch ($TimeoutAction) {
          'Disconnect' {
            # Explicit setting of DisconnectWithBusy
            if (-not $PSBoundParameters.ContainsKey('TimeoutAction')) {
              Write-Verbose -Message "'$NameNormalised' TimeoutAction '$TimeoutAction': No Timeout-Parameters are processed" -Verbose
            }
            #else: No Action
          }
          'Forward' {
            # Forward requires an TimeoutActionTarget (Tel URI, ObjectId of UPN of a User or an Application Instance to be translated to GUID)
            $Target = $TimeoutActionTarget
            $CallTarget = Get-TeamsCallableEntity -Identity "$Target"
            switch ( $CallTarget.ObjectType ) {
              'TelURI' {
                #Telephone Number (E.164)
                $Parameters += @{'TimeoutActionTarget' = $CallTarget.Identity }
              }
              'User' {
                try {
                  $Assertion = $null
                  $Assertion = Assert-TeamsCallableEntity -UserPrincipalName "$($CallTarget.Entity)" -RequireEV -InformationAction SilentlyContinue -WarningAction SilentlyContinue -ErrorAction Stop
                  if ($Assertion) {
                    $Parameters += @{'TimeoutActionTarget' = $CallTarget.Identity }
                  }
                  else {
                    Write-Warning -Message "'$NameNormalised' TimeoutAction '$TimeoutAction': TimeoutActionTarget '$TimeoutActionTarget' not asserted"
                  }
                }
                catch {
                  Write-Warning -Message "'$NameNormalised' TimeoutAction '$TimeoutAction': TimeoutActionTarget '$TimeoutActionTarget' Error: $($_.Exception.Message)"
                }
              }
              'ResourceAccount' {
                try {
                  $Assertion = $null
                  $Assertion = Assert-TeamsCallableEntity -UserPrincipalName "$($CallTarget.Entity)" -InformationAction SilentlyContinue -WarningAction SilentlyContinue -ErrorAction Stop
                  if ($Assertion) {
                    $Parameters += @{'TimeoutActionTarget' = $CallTarget.Identity }
                  }
                  else {
                    Write-Warning -Message "'$NameNormalised' TimeoutAction '$TimeoutAction': TimeoutActionTarget '$TimeoutActionTarget' not asserted"
                  }
                }
                catch {
                  Write-Warning -Message "'$NameNormalised' TimeoutAction '$TimeoutAction': TimeoutActionTarget '$TimeoutActionTarget' Error: $($_.Exception.Message)"
                }
              }
              default {
                # Capturing any other specified Target that does not match for the Forward
                Write-Warning -Message "'$NameNormalised' TimeoutAction '$TimeoutAction': TimeoutActionTarget '$TimeoutActionTarget' is incompatible and is not processed!"
                Write-Verbose -Message "'$NameNormalised' TimeoutAction '$TimeoutAction': TimeoutActionTarget expected is: Tel URI or a UPN of a User or Resource Account" -Verbose
              }
            }
          }
          'VoiceMail' {
            # VoiceMail requires an TimeoutActionTarget (UPN of a User to be translated to GUID)
            $Target = $TimeoutActionTarget
            $CallTarget = Get-TeamsCallableEntity -Identity "$Target"
            if ($CallTarget.ObjectType -eq 'User') {
              try {
                $Assertion = $null
                $Assertion = Assert-TeamsCallableEntity -UserPrincipalName "$($CallTarget.Entity)" -RequireEV -WarningAction SilentlyContinue -ErrorAction Stop
                if ($Assertion) {
                  $Parameters += @{'TimeoutActionTarget' = $CallTarget.Identity }
                }
                else {
                  Write-Warning -Message "'$NameNormalised' TimeoutAction '$TimeoutAction': TimeoutActionTarget '$TimeoutActionTarget' not asserted"
                }
              }
              catch {
                Write-Warning -Message "'$NameNormalised' TimeoutAction '$TimeoutAction': TimeoutActionTarget '$TimeoutActionTarget' Error: $($_.Exception.Message)"
              }
            }
            else {
              Write-Warning -Message "'$NameNormalised' TimeoutAction '$TimeoutAction': TimeoutActionTarget '$TimeoutActionTarget' is incompatible and is not processed!"
              Write-Verbose -Message "'$NameNormalised' TimeoutAction '$TimeoutAction': TimeoutActionTarget expected is: UPN of a User" -Verbose
            }
          }
          'SharedVoiceMail' {
            # SharedVoiceMail requires an TimeoutActionTarget (UPN of a Group to be translated to GUID)
            #region SharedVoiceMail prerequisites
            if ($PSBoundParameters.ContainsKey('TimeoutSharedVoicemailAudioFile') -and $PSBoundParameters.ContainsKey('TimeoutSharedVoicemailTextToSpeechPrompt')) {
              # Both Parameters provided
              Write-Verbose -Message "'$NameNormalised' TimeoutAction '$TimeoutAction': TimeoutSharedVoicemailAudioFile and TimeoutSharedVoicemailTextToSpeechPrompt are mutually exclusive. Processing File only" -Verbose
              [void]$PSBoundParameters.Remove('TimeoutSharedVoicemailTextToSpeechPrompt')
            }
            elseif (-not $PSBoundParameters.ContainsKey('TimeoutSharedVoicemailAudioFile') -and -not $PSBoundParameters.ContainsKey('TimeoutSharedVoicemailTextToSpeechPrompt')) {
              # Neither Parameter provided
              Write-Error -Message "'$NameNormalised' TimeoutAction '$TimeoutAction': Parameter TimeoutSharedVoicemailAudioFile or TimeoutSharedVoicemailTextToSpeechPrompt missing" -ErrorAction Stop -RecommendedAction 'Add one of the two parameters'
              return
            }
            elseif ($PSBoundParameters.ContainsKey('TimeoutSharedVoicemailTextToSpeechPrompt')) {
              if (-not $PSBoundParameters.ContainsKey('LanguageId')) {
                Write-Error -Message "'$NameNormalised' TimeoutAction '$TimeoutAction': TimeoutSharedVoicemailTextToSpeechPrompt requires Language selection. Please provide Parameter LanguageId" -ErrorAction Stop -RecommendedAction 'Add Parameter LanguageId'
                return
              }
              else {
                Write-Verbose -Message "'$NameNormalised' TimeoutAction '$TimeoutAction': TimeoutSharedVoicemailTextToSpeechPrompt: Language '$Language' is used" -Verbose
              }
            }
            elseif ($PSBoundParameters.ContainsKey('TimeoutSharedVoicemailAudioFile')) {
              # Asserting provided Audio File
              if ( -not (Assert-TeamsAudioFile "$TimeoutSharedVoicemailAudioFile")) {
                Write-Warning -Message 'TimeoutSharedVoicemailAudioFile: AudioFile could not be imported. Please validate!'
                [void]$PSBoundParameters.Remove('TimeoutSharedVoicemailAudioFile')
              }
            }
            #endregion

            #region TimeoutAction SharedVoicemail - Processing Parameters
            # For NEW, we process all under the condition that TimeOutAction is set.
            # For SET, we process them separately, but dependent on the current status of TimeOutAction or provided parameter
            # Affected parameters: TimeoutActionTarget, TimeoutSharedVoicemailAudioFile, TimeoutSharedVoicemailTextToSpeechPrompt & EnableTimeoutSharedVoicemailTranscription

            if (-not $PSBoundParameters.ContainsKey('TimeoutSharedVoicemailAudioFile') -and -not $PSBoundParameters.ContainsKey('TimeoutSharedVoicemailTextToSpeechPrompt')) {
              # Not processing SharedVoicemail parameters if - after validation - neither AudioFile nor Text-to-Voice are present
              Write-Warning -Message "'$NameNormalised' TimeoutAction '$TimeoutAction': Parameter TimeoutSharedVoicemailAudioFile or TimeoutSharedVoicemailTextToSpeechPrompt missing"
              #Write-Error -Message "'$NameNormalised' TimeoutAction '$TimeoutAction': Parameter TimeoutSharedVoicemailAudioFile or TimeoutSharedVoicemailTextToSpeechPrompt missing" -ErrorAction Stop -RecommendedAction 'Add one of the two parameters'
              #return
            }
            else {
              #region TimeoutAction SharedVoicemail - Processing TimeoutActionTarget
              Write-Verbose -Message "'$NameNormalised' TimeoutAction '$TimeoutAction': TimeoutActionTarget '$TimeoutActionTarget' - Querying Object"
              $CallTarget = $null
              $CallTarget = Get-TeamsCallableEntity -Identity "$TimeoutActionTarget"
              switch ( $CallTarget.ObjectType ) {
                'Group' {
                  $TimeoutActionTargetId = $CallTarget.Identity
                  Write-Verbose -Message "'$NameNormalised' TimeoutAction '$TimeoutAction': TimeoutActionTarget '$TimeoutActionTarget' - Object found!"
                  $Parameters += @{'TimeoutActionTarget' = $TimeoutActionTargetId }
                }
                'Unknown' {
                  Write-Warning -Message "'$NameNormalised' TimeoutAction '$TimeoutAction': TimeoutActionTarget '$TimeoutActionTarget' not set! Error enumerating Target"
                  if ($PSBoundParameters.ContainsKey('Debug') -or $DebugPreference -eq 'Continue') {
                    " Function: $($MyInvocation.MyCommand.Name) - CallTarget:", ($CallTarget | Format-Table -AutoSize | Out-String).Trim() | Write-Debug
                  }
                }
                default {
                  Write-Warning -Message "'$NameNormalised' TimeoutAction '$TimeoutAction': TimeoutActionTarget '$TimeoutActionTarget' not a Group!"
                }
              }
              #endregion

              #region TimeoutAction SharedVoicemail - Processing TimeoutSharedVoicemailAudioFile
              if ($PSBoundParameters.ContainsKey('TimeoutSharedVoicemailAudioFile')) {
                if ($TimeoutAction -ne 'SharedVoicemail') {
                  Write-Verbose -Message "'$NameNormalised' TimeoutSharedVoicemailAudioFile: Not processing Parameter as it is not valid for TimeoutAction '$TimeoutAction'" -Verbose
                }
                else {
                  $ToSVmFileName = Split-Path $TimeoutSharedVoicemailAudioFile -Leaf
                  Write-Verbose -Message "'$NameNormalised' TimeoutSharedVoicemailAudioFile: Parsing: '$ToSVmFileName'"
                  try {
                    $ToSVmFile = Import-TeamsAudioFile -ApplicationType CallQueue -File "$TimeoutSharedVoicemailAudioFile" -ErrorAction STOP
                    Write-Information "INFO: Call Queue '$NameNormalised' TimeoutSharedVoicemailAudioFile: Using: '$($ToSVmFile.FileName)'"
                    $Parameters += @{'TimeoutSharedVoicemailAudioFilePrompt' = $ToSVmFile.Id }
                  }
                  catch {
                    Write-Error -Message "Import of TimeoutSharedVoicemailAudioFile: '$ToSVmFileName' failed." -Category InvalidData -RecommendedAction 'Please check file size and compression ratio. If in doubt, provide WAV'
                    return
                  }
                }
              }
              #endregion

              #region TimeoutAction SharedVoicemail - Processing TimeoutSharedVoicemailTextToSpeechPrompt
              if ($PSBoundParameters.ContainsKey('TimeoutSharedVoicemailTextToSpeechPrompt')) {
                if ($TimeoutAction -ne 'SharedVoicemail') {
                  Write-Verbose -Message "'$NameNormalised' TimeoutSharedVoicemailTextToSpeechPrompt: Not processing Parameter as it is not valid for TimeoutAction '$TimeoutAction'" -Verbose
                }
                else {
                  if ( $TimeoutSharedVoicemailTextToSpeechPrompt.length -gt 1000 ) {
                    $TimeoutSharedVoicemailTextToSpeechPrompt = $TimeoutSharedVoicemailTextToSpeechPrompt.Trim().Substring(0, 999)
                    Write-Warning -Message 'TimeoutSharedVoicemailTextToSpeechPrompt: Message too long, cutting string at 1000 characters. Please validate!'
                  }
                  $Parameters += @{'TimeoutSharedVoicemailTextToSpeechPrompt' = "$TimeoutSharedVoicemailTextToSpeechPrompt" }
                }
              }
              #endregion

              #region TimeoutAction SharedVoicemail - Processing EnableTimeoutSharedVoicemailTranscription
              if ($PSBoundParameters.ContainsKey('EnableTimeoutSharedVoicemailTranscription')) {
                if ($TimeoutAction -ne 'SharedVoicemail') {
                  Write-Verbose -Message "'$NameNormalised' EnableTimeoutSharedVoicemailTranscription: Not processing Parameter as it is not valid for TimeoutAction '$TimeoutAction'" -Verbose
                }
                else {
                  $Parameters += @{'EnableTimeoutSharedVoicemailTranscription' = $EnableTimeoutSharedVoicemailTranscription }
                }
              }
              #endregion
            }
            #endregion
          }
        }
      }
      catch {
        Write-Warning -Message "'$NameNormalised' TimeoutAction '$TimeoutAction': TimeoutActionTarget '$TimeoutActionTarget' not set! Error enumerating Target: $($_.Exception.Message)"
      }
    }
    #endregion

    #region TimeoutAction Parameter cleanup
    if ($Parameters.TimeoutActionTarget -eq '') {
      [void]$Parameters.Remove('TimeoutActionTarget')
    }
    if ($Parameters.ContainsKey('TimeoutAction') -and (-not $Parameters.ContainsKey('TimeoutActionTarget')) -and ($TimeoutAction -ne 'Disconnect')) {
      Write-Verbose -Message "'$NameNormalised' TimeoutAction '$TimeoutAction': Action not set as TimeoutActionTarget was not correctly enumerated" -Verbose
      [void]$Parameters.Remove('TimeoutAction')
    }
    else {
      if ($Parameters.ContainsKey('TimeoutAction')) {
        Write-Information "INFO: Call Queue '$NameNormalised' TimeoutAction: '$TimeoutAction'"
      }
    }
    # For NEW: We remove all SharedVoicemail Parameters if no Target is present
    # For SET: Parameters may be applied individually (no removal of SharedVoicemail parameters)
    if ($Parameters.TimeoutActionTarget) {
      Write-Information "INFO: Call Queue '$NameNormalised' TimeoutActionTarget: '$TimeoutActionTarget'"
    }
    else {
      [void]$Parameters.Remove('TimeoutSharedVoicemailTextToSpeechPrompt')
      [void]$Parameters.Remove('TimeoutSharedVoicemailAudioFile')
      [void]$Parameters.Remove('EnableTimeoutSharedVoicemailTranscription')
    }
    #endregion
    #endregion


    #region Call Queue Agents & Channel
    $StatusID0 = 'Call Queue Agents incl. Channel'
    #region Users - Parsing and verifying Users
    $CurrentOperationID0 = 'Parsing Users'
    Write-BetterProgress -Id 0 -Activity $ActivityID0 -Status $StatusID0 -CurrentOperation $CurrentOperationID0 -Step ($private:CountID0++) -Of $private:StepsID0
    if ($PSBoundParameters.ContainsKey('Users')) {
      Write-Verbose -Message "'$NameNormalised' - Parsing Users"
      [System.Collections.Generic.List[object]]$UserIdList = @()
      foreach ($User in $Users) {
        $Assertion = $null
        $CallTarget = $null
        $CallTarget = Get-TeamsCallableEntity -Identity "$User"
        if ( $CallTarget.ObjectType -ne 'User') {
          Write-Warning -Message "'$NameNormalised' Object '$User' is not a User, omitting Object!"
          continue
        }
        try {
          # Asserting Object - Validation of Type
          $Assertion = Assert-TeamsCallableEntity -UserPrincipalName "$($CallTarget.Entity)" -RequireEV -WarningAction SilentlyContinue -ErrorAction Stop
          if ( $Assertion ) {
            Write-Information "INFO: User '$User' will be added to CallQueue"
            [void]$UserIdList.Add($CallTarget.Identity)
          }
          else {
            Write-Warning -Message "'$NameNormalised' Object '$User' not found or in usable state, omitting Object!"
            continue
          }
        }
        catch {
          Write-Warning -Message "'$NameNormalised' Object '$User' not in correct state or not enabled for Enterprise Voice, omitting Object!"
          Write-Debug "Exception: $($_.Exception.Message)"
          continue
        }
      }

      if ($UserIdList.Count -gt 0 -and $UserIdList -ne '') {
        # If Object is an Empty String, Count will be 1
        Write-Verbose -Message "'$NameNormalised' Users: Adding $($UserIdList.Count) Users as Agents to the Queue" -Verbose
        $Parameters += @{'Users' = if ( $UserIdList.Count -eq 1 ) { "$UserIdList" } else { @($UserIdList) } }
      }
    }
    #endregion

    #region Groups - Parsing Distribution Lists and their Users
    $CurrentOperationID0 = 'Parsing Distribution Lists'
    Write-BetterProgress -Id 0 -Activity $ActivityID0 -Status $StatusID0 -CurrentOperation $CurrentOperationID0 -Step ($private:CountID0++) -Of $private:StepsID0
    if ($PSBoundParameters.ContainsKey('DistributionLists')) {
      Write-Verbose -Message "'$NameNormalised' Parsing Distribution Lists" -Verbose
      [System.Collections.Generic.List[object]]$DLIdList = @()
      foreach ($DL in $DistributionLists) {
        $DLObject = $null
        $DLObject = Get-TeamsCallableEntity -Identity "$DL"
        if ($DLObject) {
          Write-Information "INFO: Call Queue '$NameNormalised' Group '$DL' will be added to the Call Queue"
          # Test whether Users in DL are enabled for EV and/or licensed?

          # Add to List
          [void]$DLIdList.Add($DLObject.Identity)
        }
        else {
          Write-Warning -Message "Group '$DL' not found or not unique in AzureAd, omitting Group!"
        }
      }

      if ($DLIdList.Count -gt 0 -and $DLIdList -ne '') {
        # If Object is an Empty String, Count will be 1
        Write-Verbose -Message "'$NameNormalised' Groups: Adding $($DLIdList.Count) Groups to the Queue" -Verbose
        $Parameters += @{'DistributionLists' = if ( $DLIdList.Count -eq 1 ) { "$DLIdList" } else { @($DLIdList) } }
        Write-Information 'INFO: Group members are parsed by the subsystem and are not validated regarding Licensing or EV-Enablement'
      }
    }
    #endregion

    #region ChannelOwner - Parsing and verifying ChannelOwner
    $CurrentOperationID0 = 'Parsing ChannelOwner'
    Write-BetterProgress -Id 0 -Activity $ActivityID0 -Status $StatusID0 -CurrentOperation $CurrentOperationID0 -Step ($private:CountID0++) -Of $private:StepsID0
    if ($PSBoundParameters.ContainsKey('ChannelOwner')) {
      Write-Verbose -Message "'$NameNormalised' Parsing ChannelOwner"
      $Assertion = $null
      $CallTarget = $null
      $CallTarget = Get-TeamsCallableEntity -Identity "$ChannelOwner"
      if ( $CallTarget.ObjectType -ne 'User') {
        Write-Warning -Message "'$NameNormalised' Object '$ChannelOwner' is not a User, omitting Object!"
        continue
      }
      try {
        # Asserting Object - Validation of Type
        $Assertion = Assert-TeamsCallableEntity -UserPrincipalName "$($CallTarget.Entity)" -RequireEV -WarningAction SilentlyContinue -ErrorAction Stop
        if ( $Assertion ) {
          Write-Information "INFO: User '$ChannelOwner' will be added to CallQueue"
          $Parameters += @{'ChannelUserObjectId' = "$($CallTarget.Identity)" }
        }
        else {
          Write-Warning -Message "'$NameNormalised' Object '$ChannelOwner' not found or in usable state, omitting Object!"
          continue
        }
      }
      catch {
        Write-Warning -Message "'$NameNormalised' Object '$ChannelOwner' not in correct state or not enabled for Enterprise Voice, omitting Object!"
        Write-Debug "Exception: $($_.Exception.Message)"
        continue
      }
    }
    #endregion

    #region Channel
    $CurrentOperationID0 = 'Parsing Channel'
    Write-BetterProgress -Id 0 -Activity $ActivityID0 -Status $StatusID0 -CurrentOperation $CurrentOperationID0 -Step ($private:CountID0++) -Of $private:StepsID0
    if ($PSBoundParameters.ContainsKey('TeamAndChannel')) {
      Write-Verbose -Message "'$NameNormalised' Parsing Team and Channel" -Verbose
      try {
        $TeamString, $ChannelString = $TeamAndChannel.split('`\')
        $Team, $Channel = $null
        $Team, $Channel = Get-TeamsTeamAndChannel -String "$TeamAndChannel" -ErrorAction Stop
        #$Team, $Channel = Get-TeamAndChannel -String "$TeamAndChannel" -ErrorAction Stop
        if ( -not $Team ) { throw "Team '$TeamString' could not be determined." }
        if ( -not $Channel ) { throw "Channel '$ChannelString' could not be determined." }
        Write-Verbose "Call Queue '$NameNormalised' TeamAndChannel: Determining Distribution Group" -Verbose
        $ChannelGroups = Get-AzureADGroup -SearchString "$($Team.DisplayName)"
        $ChannelGroup = $ChannelGroups | Where-Object DisplayName -EQ "$($Team.DisplayName)"
        if ( -not $ChannelGroup ) { throw 'Channel Distribution Group cannot be determined' }
        Write-Information "INFO: Call Queue '$NameNormalised' TeamAndChannel: Distribution Group '$($Team.DisplayName)' used"
        $Parameters += @{'DistributionLists' = $ChannelGroup.ObjectId }

        if ( -not $PSBoundParameters.ContainsKey('ChannelOwner') ) {
          Write-Verbose "Call Queue '$NameNormalised' TeamAndChannel: Determining Channel Owner" -Verbose
          #TEST Works but Get-TeamChannelUser is designed to provide an Owner rather than any member
          #$ChannelOwnerObjectId = Get-AzureADGroupMember -ObjectId $ChannelGroup.ObjectId | Select-Object ObjectId -First 1 -ExpandProperty ObjectId
          $ChannelOwnerObjectId = Get-TeamChannelUser -GroupId $Team.GroupId -DisplayName $Channel.DisplayName -Role Owner | Select-Object UserId -First 1 -ExpandProperty UserId
          if ( $null -eq $ChannelOwnerObjectId ) { throw "No Channel Owner discovered in channel '$ChannelString'" }
          Write-Information "INFO: Call Queue '$NameNormalised' TeamAndChannel: ChannelOwner '$ChannelOwnerObjectId' determined and used"
          $Parameters += @{'ChannelUserObjectId' = "$ChannelOwnerObjectId" }
        }

        if ( -not $Parameters.ContainsKey('ChannelUserObjectId')  ) {
          throw "Channel Owner could not be determined for Channel '$ChannelString'"
        }
        else {
          Write-Information "INFO: Call Queue '$NameNormalised' TeamAndChannel: Team '$($Team.DisplayName)' - Channel '$($Channel.DisplayName)' will be added to the Call Queue"
          $Parameters += @{'ChannelId' = $Channel.Id }
        }
      }
      catch {
        Write-Warning -Message "TeamAndChannel: Error parsing Object. Target will not be added to the Call Queue. Exception: $($_.Exception.Message)"
      }
    }
    #endregion
    #endregion

    #region CallerId Accounts & Managers
    $StatusID0 = 'Caller Id & Managers'
    #region ResourceAccountsForCallerId - Parsing and verifying Parsing Resource Accounts for Caller Id
    $CurrentOperationID0 = 'Parsing Resource Accounts for Caller Id'
    Write-BetterProgress -Id 0 -Activity $ActivityID0 -Status $StatusID0 -CurrentOperation $CurrentOperationID0 -Step ($private:CountID0++) -Of $private:StepsID0
    if ($PSBoundParameters.ContainsKey('ResourceAccountsForCallerId')) {
      Write-Verbose -Message "'$NameNormalised' Parsing Resource Accounts for Caller Id"
      [System.Collections.Generic.List[object]]$OboResourceAccountIds = @()
      foreach ($RA in $ResourceAccountsForCallerId) {
        $Assertion = $null
        $CallTarget = $null
        $CallTarget = Get-TeamsCallableEntity -Identity "$RA"
        if ( $CallTarget.ObjectType -ne 'ResourceAccount') {
          Write-Warning -Message "'$NameNormalised' Object '$RA' is not a Resource Account, omitting Object!"
          continue
        }
        try {
          # Asserting Object - Validation of Type
          $Assertion = Assert-TeamsCallableEntity -UserPrincipalName "$($CallTarget.Entity)" -RequireEV -WarningAction SilentlyContinue -ErrorAction Stop
          if ( $Assertion ) {
            Write-Information "INFO: Call Queue '$NameNormalised' Resource Account '$RA' will be added to CallQueue"
            [void]$OboResourceAccountIds.Add($CallTarget.Identity)
          }
          else {
            Write-Warning -Message "'$NameNormalised' Object '$RA' not found or in usable state, omitting Object!"
            continue
          }
        }
        catch {
          Write-Warning -Message "'$NameNormalised' Object '$RA' not in correct state or not enabled for Enterprise Voice, omitting Object!"
          Write-Debug "Exception: $($_.Exception.Message)"
          continue
        }
      }

      if ($OboResourceAccountIds.Count -gt 0 -and $OboResourceAccountIds -ne '') {
        # If Object is an Empty String, Count will be 1
        Write-Verbose -Message "'$NameNormalised' Resource Account: Adding $($OboResourceAccountIds.Count) Resource Accounts for Caller Id to the Queue" -Verbose
        $Parameters += @{'OboResourceAccountIds' = if ( $OboResourceAccountIds.Count -eq 1 ) { "$OboResourceAccountIds" } else { @($OboResourceAccountIds) } }
      }
    }
    #endregion

    #region AuthorizedUsers - Parsing and verifying AuthorizedUsers
    $CurrentOperationID0 = 'Parsing AuthorizedUsers'
    Write-BetterProgress -Id 0 -Activity $ActivityID0 -Status $StatusID0 -CurrentOperation $CurrentOperationID0 -Step ($private:CountID0++) -Of $private:StepsID0
    if ($PSBoundParameters.ContainsKey('AuthorizedUsers')) {
      Write-Verbose -Message "'$NameNormalised' - Parsing AuthorizedUsers"
      [System.Collections.Generic.List[object]]$AuthorizedUserIdList = @()
      foreach ($User in $AuthorizedUsers) {
        $Assertion = $null
        $CallTarget = $null
        $CallTarget = Get-TeamsCallableEntity -Identity "$User"
        if ( $CallTarget.ObjectType -ne 'User') {
          Write-Warning -Message "'$NameNormalised' Object '$User' is not a User, omitting Object!"
          continue
        }
        try {
          # Asserting Object - Validation of Type
          $Assertion = Assert-TeamsCallableEntity -UserPrincipalName "$($CallTarget.Entity)" -RequireEV -WarningAction SilentlyContinue -ErrorAction Stop
          if ( $Assertion ) {
            Write-Information "INFO: User '$User' will be added as an Authorized User"
            [void]$AuthorizedUserIdList.Add($CallTarget.Identity)
          }
          else {
            Write-Warning -Message "'$NameNormalised' Object '$User' not found or in usable state, omitting Object!"
            continue
          }
        }
        catch {
          Write-Warning -Message "'$NameNormalised' Object '$User' not in correct state or not enabled for Enterprise Voice, omitting Object!"
          Write-Debug "Exception: $($_.Exception.Message)"
          continue
        }
      }

      if ($AuthorizedUserIdList.Count -gt 0 -and $AuthorizedUserIdList -ne '') {
        # If Object is an Empty String, Count will be 1
        Write-Verbose -Message "'$NameNormalised' AuthorizedUsers: Adding $($AuthorizedUserIdList.Count) Users as Managers to the Queue" -Verbose
        $Parameters += @{'AuthorizedUsers' = if ( $AuthorizedUserIdList.Count -eq 1 ) { "$AuthorizedUserIdList" } else { @($AuthorizedUserIdList) } }
      }
    }
    #endregion
    #endregion


    #region Common parameters
    $Parameters += @{'WarningAction' = 'Continue' }
    $Parameters += @{'ErrorAction' = 'Stop' }
    #endregion
    #endregion


    #region ACTION
    $StatusID0 = 'Creating Object'
    $CurrentOperationID0 = "Creating Call Queue: '$NameNormalised'"
    Write-BetterProgress -Id 0 -Activity $ActivityID0 -Status $StatusID0 -CurrentOperation $CurrentOperationID0 -Step ($private:CountID0++) -Of $private:StepsID0
    if ($PSBoundParameters.ContainsKey('Debug') -or $DebugPreference -eq 'Continue') {
      " Function: $($MyInvocation.MyCommand.Name) - Parameters (New-CsCallQueue)", ($Parameters | Format-Table -AutoSize | Out-String).Trim() | Write-Debug
    }

    # Create CQ (New-CsCallQueue)
    if ($PSCmdlet.ShouldProcess("$UserPrincipalName", 'New-CsCallQueue')) {
      try {
        # Create the Call Queue with all enumerated Parameters passed through splatting
        $null = (New-CsCallQueue @Parameters)
        Write-Verbose -Message "SUCCESS: '$NameNormalised' Call Queue created with all Parameters"
      }
      catch {
        if ( $_.Exception.Message.contains('Users') ) {
          [void]$Parameters.Remove('Users')
          Write-Warning -Message "Parameter Users threw Exception ('$($_.Exception.Message)')"
        }
        elseif ( $_.Exception.Message.contains('DistributionLists') ) {
          [void]$Parameters.Remove('DistributionLists')
          Write-Warning -Message "Parameter DistributionLists threw Exception ('$($_.Exception.Message)')"
        }
        elseif ( $_.Exception.Message.contains('OboResourceAccountIds') ) {
          [void]$Parameters.Remove('OboResourceAccountIds')
          Write-Warning -Message "Parameter OboResourceAccountIds threw Exception ('$($_.Exception.Message)')"
        }
        else {
          Write-Error -Message "Error creating the Call Queue: $($_.Exception.Message)" -Category InvalidOperation
          return
        }
        Write-Warning -Message 'Removing parameter and creating Call Queue without the parameter. Please rectify manually afterwards'
        try {
          # Create the Call Queue with all enumerated Parameters passed through splatting, except offending Parameter
          $null = (New-CsCallQueue @Parameters)
          Write-Verbose -Message "SUCCESS: '$NameNormalised' Call Queue created with all Parameters except removed one"
        }
        catch {
          Write-Error -Message "Error creating the Call Queue: $($_.Exception.Message)" -Category InvalidOperation
          return
        }
      }
    }
    else {
      return
    }
    #endregion


    #region OUTPUT
    $CurrentOperationID0 = 'Preparing Output'
    Write-BetterProgress -Id 0 -Activity $ActivityID0 -Status $StatusID0 -CurrentOperation $CurrentOperationID0 -Step ($private:CountID0++) -Of $private:StepsID0
    $CallQueueFinal = Get-TeamsCallQueue -Name "$NameNormalised" -WarningAction SilentlyContinue
    $CallQueueFinal = $CallQueueFinal | Where-Object Name -EQ "$NameNormalised"

    Write-Progress -Id 0 -Activity $ActivityID0 -Completed
    Write-Output $CallQueueFinal
    #endregion

  } #process

  end {
    Write-Verbose -Message "[END ] $($MyInvocation.MyCommand)"

  } #end
} #New-TeamsCallQueue