.png)
New-CsAnnouncement
Dernière rubrique modifiée : 2013-02-20
Crée une nouvelle annonce Lync Server. Les annonces sont diffusées lorsque les utilisateurs composent un numéro valide mais non attribué. Une annonce peut être un message (du type « Ce numéro n’est pas en service actuellement ») ou une tonalité d’occupation. Cette applet de commande est une nouveauté de Lync Server 2010.
New-CsAnnouncement -Parent <String> <COMMON PARAMETERS>
New-CsAnnouncement -Identity <XdsIdentity> <COMMON PARAMETERS>
COMMON PARAMETERS: -Name <String> [-AudioFilePrompt <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Language <String>] [-TargetUri <String>] [-TextToSpeechPrompt <String>] [-WhatIf [<SwitchParameter>]]
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.
New-CsAnnouncement -Identity ApplicationServer:redmond.litwareinc.com -Name "Help Desk Announcement" -TextToSpeechPrompt "Welcome to the Help Desk." -Language "en-US"
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 l’applet de commande Import-CsAnnouncementFile.
New-CsAnnouncement -Identity ApplicationServer:redmond.litwareinc.com -Name "Welcome Announcement" -AudioFilePrompt "WelcomeMessage.wav"
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.
New-CsAnnouncement -Identity ApplicationServer:redmond.litwareinc.com -Name "Forward Announcement" -AudioFilePrompt "WelcomeMessage.wav" -TargetUri sip:kmyer@litwareinc.com
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.
New-CsAnnouncement -Identity ApplicationServer:redmond.litwareinc.com -Name "Forward Announcement" -AudioFilePrompt "WelcomeMessage.wav" -TargetUri "sip:+14255551212@litwareinc.com;user=phone"
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.
New-CsAnnouncement -Identity ApplicationServer:redmond.litwareinc.com -Name "Busy"
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 applet de commande crée des paramètres d’annonce.
Vous pouvez affecter des annonces aux numéros non affectés en appelant l’applet de commande New-CsUnassignedNumber ou l’applet de commande Set-CsUnassignedNumber.
Personnes autorisées à exécuter cette applet de commande : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement l’applet de commande 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 applet de commande 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ètre | Obligatoire | Type | Description |
|---|---|---|---|
| Identity | Obligatoire | Microsoft.Rtc.Management.Xds.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 applet de commande. 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. |
| Name | Obligatoire | System.String | Description pour l’annonce. Ce nom doit être unique dans le service. Ce nom sera utilisé dans l’appel à l’applet de commande New-CsUnassignedNumber ou l’applet de commande Set-CsUnassignedNumber pour spécifier l’annonce associée à une série de numéros non affectés. |
| Parent | Obligatoire | System.String | 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. |
| AudioFilePrompt | Facultatif | System.String | 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 l’applet de commande Import-CsAnnouncementFile. Types de fichiers valides : WAV et WMA |
| Confirm | Facultatif | System.Management.Automation.SwitchParameter | Vous demande confirmation avant d’exécuter la commande. |
| Force | Facultatif | System.Management.Automation.SwitchParameter | Supprime les invites de confirmation qui s’affichent avant d’effectuer des modifications. |
| InMemory | Facultatif | System.Management.Automation.SwitchParameter | 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. |
| Language | Facultatif | System.String | 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, Espagne), 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, République de 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, Taiwan). |
| TargetUri | Facultatif | System.String | 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 | System.String | 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. |
| WhatIf | Facultatif | System.Management.Automation.SwitchParameter | Décrit ce qui se passe si vous exécutez la commande sans l’exécuter réellement. |
Aucun.
Crée un objet du type Microsoft.Rtc.Management.WritableConfig.Settings.AnnouncementServiceSettings.Announcement.
