Partager via

  • Article

Set-CsAnnouncement

 

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

Modifie les valeurs de propriété d’une annonce Microsoft Lync Server 2010 existante. 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.

Syntaxe

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

Set-CsAnnouncement [-AudioFilePrompt <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Language <String>] [-Name <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 attribués, les administrateurs peuvent diffuser un message, retourner une tonalité d’occupation ou rediriger l’appel. Cette cmdlet permet de modifier ces paramètres d’annonce.

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Set-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 "Set-CsAnnouncement"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur unique de l’annonce. Cette valeur sera toujours au format <IDservice>/<GUID>, où IDservice est la propriété Identity du serveur d’applications exécutant le service d’annonce et GUID est l’identificateur global unique associé à ces paramètres d’annonce. Par exemple : ApplicationServer:redmond.litwareinc.com/bef5fa3b-3c97-4af0-abe7-611deee7616c.

Parce qu’il peut être difficile de saisir des GUID à l’invite de commande, vous récupérerez plus probablement les annonces à l’aide de la cmdlet Get-CsAnnouncement et les redirigerez vers la cmdlet Set-CsAnnouncement pour les modifier. (Pour plus de détails, consultez section Exemples.)

Instance

Facultatif

Annonce

Référence de l’objet Announcement à modifier. Cet objet doit être de type Microsoft.Rtc.Management.WritableConfig.Settings.AnnouncementServiceSettings.Announcement pour pouvoir être récupéré en appelant la cmdlet Get-CsAnnouncement.

Name

Facultatif

Chaîne

Entrez une valeur pour ce paramètre afin de changer le nom de l’annonce. Les noms doivent être uniques au sein d’un service.

AudioFilePrompt

Facultatif

Chaîne

Nom du fichier audio à diffuser 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.

TextToSpeechPrompt

Facultatif

Chaîne

Invite de synthèse vocale. Il s’agit d’une chaîne qui sera convertie en audio et diffusée 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.

Language

Facultatif

Chaîne

Langue dans laquelle l’invite de synthèse vocale sera affichée. Si une valeur est indiquée pour TextToSpeechPrompt, ce paramètre est requis.

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 vers lequel l’appelant sera transféré après la diffusion de l’annonce. Cette valeur doit être une adresse SIP 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.

Force

Facultatif

Paramètre de commutateur

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

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

Facultatif

Paramètre de commutateur

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

Types d’entrées

Objet Microsoft.Rtc.Management.WritableConfig.Settings.AnnouncementServiceSettings.Announcement. Accepte la saisie de données transmises via le pipeline pour les objets d’annonce.

Types de retours

Set-CsAnnouncement ne retourne ni objet, ni valeur. Au lieu de cela, la cmdlet modifie les instances existantes de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.AnnouncementServiceSettings.Announcement.

Exemple

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

Get-CsAnnouncement | Where-Object {$_.Name -eq "Help Desk Announcement"} | Set-CsAnnouncement -AudioFilePrompt "helpdesk.wav"

La commande illustrée dans l’exemple 1 attribue un nouveau fichier audio à l’annonce Help Desk. Pour cela, la commande utilise d’abord Get-CsAnnouncement, sans paramètre, afin de retourner une collection de toutes les annonces disponibles actuellement. Cette collection est ensuite redirigée vers la cmdlet Where-Object, qui choisit l’annonce dans laquelle la propriété Name est égale à (-eq) « Help Desk Announcement ». Ensuite, cette annonce est redirigée vers Set-CsAnnouncement, qui définit la valeur de la propriété AudioFilePrompt sur helpdesk.wav.

Notez que si cette annonce s'est déjà vu attribué une valeur TextToSpeechPrompt, cette commande générera un avertissement indiquant que la valeur TextToSpeechPrompt sera ignorée.

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

Get-CsAnnouncement | Where-Object {$_.Name -eq "Help Desk Announcement"} | Set-CsAnnouncement -TextToSpeechPrompt $Null

Dans l’exemple 2, la propriété TextToSpeechPrompt pour l’annonce Help Desk Announcement est définie sur une valeur Null, ce qui efface la valeur de propriété. Pour cela, la commande utilise d’abord Get-CsAnnouncement pour retourner une collection de toutes les annonces disponibles actuellement. Cette collection est ensuite redirigée vers la cmdlet Where-Object, qui choisit l’annonce dans laquelle la propriété Name est égale à (-eq) « Help Desk Announcement ». Cette annonce est ensuite redirigée vers la cmdlet Set-CsAnnouncement, qui définit la propriété TextToSpeechPrompt sur une valeur Null ($Null).

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

Get-CsAnnouncement | Where-Object {$_.Name -eq "Help Desk Announcement"} | Set-CsAnnouncement -TargetUri "sip:kmyer@litwareinc.com;opaque=app:voicemail"

Cet exemple met à jour le TargetUri pour l’annonce dont le nom est Help Desk Announcement. La commande utilise d’abord Get-CsAnnouncement pour retourner une collection de toutes les annonces disponibles actuellement. Cette collection est ensuite redirigée vers la cmdlet Where-Object, qui choisit l’annonce dans laquelle la propriété Name est égale à (-eq) « Help Desk Announcement ». Cette annonce est ensuite redirigée vers la cmdlet Set-CsAnnouncement, qui définit la propriété TargetUri sur un emplacement de messagerie vocale (sip:kmyer@litwareinc.com;opaque=app:voicemail).