Topic Last Modified: 2010-11-07

When you configure announcements, you are really configuring how you want calls to unassigned numbers to be handled. You can play a prompt, which can be an audio file or a text-to-speech (TTS) file, or you can just transfer the call to a specified destination without playing a prompt.

To create a new announcement, you perform the following steps:

  1. For audio prompts, record the audio file by using your favorite audio recording application.

  2. For audio prompts, run the Import-CsAnnouncementFile cmdlet to import the contents of the audio file to File Store.

  3. Run the New-CsAnnouncement cmdlet to create and name the announcement. Perform this step to create announcements with an audio prompt, a TTS prompt, or no prompt.

    You might want to create an announcement with no prompt, for example, if you want to transfer calls to a specific destination without playing a message.
  4. Assign the new announcement to a number range in the unassigned number table.

This topic describes how to import and create announcements. For information about assigning announcements in the unassigned number table, see Configure the Unassigned Number Table.

To create a new announcement

  1. For audio prompts, create the audio file.

  2. Log on as a member of the RTCUniversalServerAdmins group, or as a member of one of the predefined administrative roles that support Announcement. If you are not logged on as a member of one of these roles, you are prompted for alternate credentials.

  3. Start the Lync Server Management Shell: Click Start, click All Programs, click Microsoft Lync Server 2010, and then click Lync Server Management Shell.

  4. For audio prompts, run:

    Copy Code
    Import-CsAnnouncementFile -Parent <service of the Application Server running the Announcement application> -FileName <name for file in File Store> -Content Byte [<contents of file in byte array>]
  5. Run:

    Copy Code
    New-CsAnnouncement -Parent <service of Application Server running the Announcement application, in the form: service:ApplicationServer:<fqdn> > `
    -Name <unique name to be used as destination in unassigned number table> `
    [-AudioFilePrompt <FileName specified in Import-CsAnnouncementFile>] `
    [-TextToSpeechPrompt <text string to be converted to speech>] `
    [-Language <Language for playing the TTS prompt (required for PromptTts)>] `
    [-TargetUri sip:SIPAddress for transferring caller after announcement]

    For transferring calls to voice mail, type SIPAddress in the format sip:username@domainname;opaque=app:voicemail (for example,;opaque=app:voicemail). For transferring calls to a phone number, type SIPAddress in the format sip:number@domainname;user=phone (for example, sip:+;user=phone).

    For example, to specify an audio prompt:

    Copy Code
    $a = Get-Content ".\PromptFile.wav" -ReadCount 0 -Encoding Byte
    Import-CsAnnouncementFile -Parent `
    -FileName "ChangedNumberMessage.wav" -Content $a
    New-CsAnnouncement -Parent `
    -Name "Number Changed Announcement" -AudioFilePrompt "ChangedNumberMessage.wav"

    For example, to specify a TTS prompt:

    Copy Code
    New-CsAnnouncement -Parent `
    -Name "Help Desk Announcement" `
    -TextToSpeechPrompt "The Help Desk number has changed. Please dial 5550100." -Language "en-US"

    For more detail about these cmdlets, and to see a list of the language codes to use in the TextToSpeechPrompt parameter, see the Lync Server Management Shell documentation or Help for Lync Server Management Shell.