Partager via

  • Article

New-CsAnnouncement

 

Dernière rubrique modifiée : 2012-03-23

Crée une nouvelle annonce Microsoft Lync Server 2010. Les utilisateurs qui composent un numéro de téléphone valide mais un numéro de téléphone non assigné entendront une annonce. Une annonce peut être un message (du type « Ce numéro n’est pas en service actuellement ») ou une tonalité d’occupation.

Syntaxe

New-CsAnnouncement -Identity <XdsIdentity> -Name <String> [-AudioFilePrompt <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Language <String>] [-TargetUri <String>] [-TextToSpeechPrompt <String>] [-WhatIf [<SwitchParameter>]]

New-CsAnnouncement -Name <String> -Parent <String> [-AudioFilePrompt <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Language <String>] [-TargetUri <String>] [-TextToSpeechPrompt <String>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Une organisation peut être propriétaire de numéros de téléphone qui ne sont pas attribués à des utilisateurs ou à des téléphones, mais qui sont tout de même valides et peuvent être appelés. Par défaut, lorsqu’une personne compose l’un de ces numéros, elle entend une tonalité d’occupation et l’appel peut générer une erreur retournée au client SIP. En appliquant des paramètres d’annonce aux numéros non assignés, les administrateurs ont l’option de lire un message, envoyer une sonnerie « occupé » ou transférer l’appel. Cette cmdlet crée des paramètres d’annonce.

Vous pouvez affecter des annonces aux numéros non affectés en appelant la cmdlet New-CsUnassignedNumber ou Set-CsUnassignedNumber.

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet New-CsAnnouncement : RTCUniversalServerAdmins. Pour retourner une liste de tous les rôles RBAC (Contrôle d’accès basé sur un rôle) auxquels cette cmdlet a été affectée (y compris les rôles RBAC personnalisés créés par vos soins), exécutez la commande suivante à l’invite Windows PowerShell :

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsAnnouncement"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

XdsIdentity

Identificateur unique de l’annonce. Pour cette valeur, vous devez saisir l’identité du serveur d’application exécutant l’application Response Group. Par exemple, ApplicationServer:redmond.litwareinc.com.

Plusieurs annonces peuvent être assignées à un service unique. Par conséquent, un identificateur global unique (GUID) est généré automatiquement et affecté à l’identité quand vous créez l’annonce, afin de donner une valeur unique à l’identité. La nouvelle annonce aura une identité au format <service ID>/<GUID>. Par exemple : service: ApplicationServer:redmond.litwareinc.com/bef5fa3b-3c97-4af0-abe7-611deee7616c. Il est inutile de fournir un GUID lorsque vous appelez cette cmdlet. Il suffit de fournir l’identité du service et le GUID sera généré automatiquement et ajouté à l’identité.

Même si fournir un GUID n’est pas obligatoire, vous pouvez tout de même le faire. Il se peut que vous vouliez en fournir un si l’annonce a été affectée à une série de numéros non affectés et qu’elle a été effacée. Vous pouvez créer une nouvelle annonce avec une identité correspondante (incluant le GUID) et dans ce cas, il n’est pas nécessaire de mettre à jour la série de numéros non assignés.

Parent

Facultatif

Chaîne

Ce paramètre est identique à l’identité, excepté que cette identité acceptera l’identité du service et le GUID, tandis que le parent n’acceptera que l’identité de service. Le GUID sera généré automatiquement. Vous ne pouvez pas spécifier à la fois une identité et un parent.

Name

Obligatoire

Chaîne

Description pour l’annonce. Ce nom doit être unique dans le service. Ce nom sera utilisé dans l’appel à New-CsUnassignedNumber ou Set-CsUnassignedNumber pour spécifier l’annonce associée à une série de numéros non affectés.

AudioFilePrompt

Facultatif

Chaîne

Le nom du fichier audio à lire pour l’annonce. Les fichiers audio sont enregistrés dans le magasin de fichiers. Pour enregistrer un fichier audio dans le magasin de fichiers, utilisez la cmdlet Import-CsAnnouncementFile.

Types de fichiers valides : WAV et WMA

Language

Facultatif

Chaîne

La langue dans laquelle l’invite TTS (text-to-speech) sera lue. Si une valeur a été saisie pour TextToSpeechPrompt, ce paramètre est obligatoire.

Les valeurs sont indiquées sous forme de chaîne représentant la langue et les paramètres régionaux à utiliser. Ci-dessous, une liste de valeurs valides suivies d’une langue et une variante linguistique entre parenthèses : ca-ES (Catalan, Catalan), da-DK (Danois, Danemark), de-DE (Allemand, Allemagne), en-AU (Anglais, Australie), en-CA (Anglais, Canada), en-GB (Anglais, Royaume-Uni), en-IN (Anglais, Inde), en-US (Anglais, États-Unis), es-ES (Espagnol, Espagne), es-MX (Espagnol, Mexique), fi-FI (Finnois, Finlande), fr-CA (Français, Canada), fr-FR (Français, France), it-IT (Italien, Italie), ja-JP (Japonais, Japon), ko-KR (Coréen, Corée), nb-NO (Norvégien, Bokmal, Norvège), nl-NL (Hollandais, Pays-Bas), pl-PL (Polonais, Pologne), pt-BR (Portugais, Brésil), pt-PT (Portugais, Portugal), ru-RU (Russe, Russie), sv-SE (Suédois, Suède), zh-CN (Chinois, République populaire de Chine), zh-HK (Chinois, Hong Kong R.A.S.), zh-TW (Chinois, Taïwan).

TargetUri

Facultatif

Chaîne

L’URI (Uniform Resource Identifier) vers lequel l’appelant sera transféré après lecture de l’annonce. Cette valeur doit être une adresse SIP à saisir au format sip: suivie de l’adresse SIP. Par exemple, sip:kmyer@litwareinc.com. Notez que l’adresse SIP peut également être un numéro de téléphone, par exemple sip:+14255551212@litwareinc.com;user=phone pour un numéro de téléphone ou sip:kmyer@litwareinc.com;opaque=app:voicemail pour une boîte vocale.

TextToSpeechPrompt

Facultatif

Chaîne

Une invite de conversion vocale de texte (TTS). Il s’agit d’une chaîne qui sera convertie en fichier audio et lue comme annonce.

Si AudioFilePrompt et TextToSpeechPrompt sont spécifiés pour une seule annonce, vous recevrez un avertissement signalant que le fichier audio a priorité et que l’invite TTS doit être ignorée.

Force

Facultatif

Paramètre de commutateur

Supprime les invites de confirmation qui s’affichent avant d’effectuer des modifications.

InMemory

Facultatif

Paramètre de commutateur

Crée une référence d’objet sans valider l’objet comme une modification définitive. Si vous affectez à une variable la sortie de cette cmdlet appelée avec ce paramètre, vous pouvez apporter des modifications aux propriétés de la référence d’objet, puis les valider en appelant la cmdlet Set- correspondante.

WhatIf

Facultatif

Paramètre de commutateur

Décrit ce qui se passe si vous exécutez la commande sans l’exécuter réellement.

Confirm

Paramètre de commutateur

Vous demande confirmation avant d’exécuter la commande.

Types d’entrées

Aucun.

Types de retours

Crée un objet du type Microsoft.Rtc.Management.WritableConfig.Settings.AnnouncementServiceSettings.Announcement.

Exemple

-------------------------- Exemple 1 --------------------------

New-CsAnnouncement -Identity ApplicationServer:redmond.litwareinc.com -Name "Help Desk Announcement" -TextToSpeechPrompt "Welcome to the Help Desk." -Language "en-US"

L’exemple 1 montre comment créer une nouvelle annonce qui lira une invite TTS en anglais (États-Unis). Le premier paramètre que nous spécifions est l’identité. L’identité, dans l’étendue de service, suivie de l’ID de service du serveur d’application (ApplicationServer:redmond.litwareinc.com). Puis, nous donnons à l’annonce un nom, dans ce cas Annonce du service d’assistance. Pour affecter une invite TTS à cette annonce, nous utilisons le paramètre TextToSpeechPrompt suivi d’une chaîne avec le texte d’annonce. Quand vous utilisez une invite TTS pour l’annonce, vous devez spécifier la langue, ce que nous faisons ici en incluant un paramètre de langue suivi d’une chaîne représentant l’anglais américain (en-US).

Notez que les identités de l’annonce ont deux parties : le service où l’annonce est stockée et un GUID de 36 caractères (identificateur global unique). Vous verrez l’identité complète une fois que vous aurez créé la nouvelle annonce. Le GUID est généré et appliqué automatiquement. Cette identité sera similaire à celle-ci : service:ApplicationServer:redmond.litwareinc.com/1951f734-c80f-4fb2-965d-51807c792b90.

-------------------------- Exemple 2 --------------------------

New-CsAnnouncement -Identity ApplicationServer:redmond.litwareinc.com -Name "Welcome Announcement" -AudioFilePrompt "WelcomeMessage.wav"

L’exemple 2 est similaire à l’exemple 1 en ce sens que nous avons commencé à saisir les paramètres requis, l’identité et le nom. Cependant, dans cet exemple, au lieu d’une invite TTS, nous voulons une annonce qui lise un fichier audio. Pour ce faire, nous incluons un paramètre AudioFilePrompt et le transférons à une chaîne contenant le nom du fichier audio (WelcomeMessage.wav). Ce fichier doit se trouver dans le magasin de fichiers pour que l’annonce puisse être lue. Vous pouvez ajouter des fichiers audio au magasin de fichiers à l’aide de la cmdlet Import-CsAnnouncementFile.

-------------------------- Exemple 3 --------------------------

New-CsAnnouncement -Identity ApplicationServer:redmond.litwareinc.com -Name "Forward Announcement" -AudioFilePrompt "WelcomeMessage.wav" -TargetUri sip:kmyer@litwareinc.com

Comme pour l’exemple 2, il s’agit ici de créer une annonce qui lira un fichier audio une fois que l’appel a abouti. Cependant, dans cet exemple, en plus de l’identité, le nom et les paramètres AudioFilePrompt, nous spécifions également le paramètre TargetUri. Nous transférons ce paramètre à l’URI du SIP de l’utilisateur ou du téléphone vers lequel l’appelant sera transféré une fois l’annonce lue.

-------------------------- Exemple 4 --------------------------

New-CsAnnouncement -Identity ApplicationServer:redmond.litwareinc.com -Name "Forward Announcement" -AudioFilePrompt "WelcomeMessage.wav" -TargetUri "sip:+14255551212@litwareinc.com;user=phone"

L’exemple 4 est identique à l’exemple 3 sauf qu’au lieu de transférer l’appel en fonction de l’adresse SIP, l’appel est transféré à un numéro de téléphone.

-------------------------- Exemple 5 --------------------------

New-CsAnnouncement -Identity ApplicationServer:redmond.litwareinc.com -Name "Busy"

Dans cet exemple, nous ne spécifiions pas d’invite ou de cible URI, nous incluons uniquement une identité et un nom. Cela signifie que l’appelant entendra une sonnerie « occupé » si l’appel au numéro non assigné, mais associé à cette annonce, aboutit.