Partager via

  • Article

Get-CsAnnouncement

 

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

Retourne des informations sur les annonces Microsoft Lync Server 2010 configurées pour être utilisées dans votre organisation. 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

Get-CsAnnouncement [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsAnnouncement [-Filter <String>] [-LocalStore <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 récupère un ou plusieurs de 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 Get-CsAnnouncement : RTCUniversalUserAdmins, 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 "Get-CsAnnouncement"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur de l’annonce que vous souhaitez récupérer. Si vous omettez ce paramètre et le paramètre Filter, toutes les instances des annonces configurées pour l’organisation s’afficheront. La valeur du paramètre Identity peut être fournie de l’une des deux façons suivantes :

- Entrez l’identité du service d’application des annonces que vous souhaitez récupérer. Vous récupérez ainsi toutes les annonces qui sont configurées avec l’identité de service fournie. Par exemple, ApplicationServer:Redmond.litwareinc.com.

- Entrez l’identité complète d’une seule annonce que vous souhaitez récupérer. 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é à cette annonce. Par exemple : ApplicationServer:Redmond.litwareinc.com/bef5fa3b-3c97-4af0-abe7-611deee7616c.

Filter

Facultatif

Chaîne

Ce paramètre vous permet d’effectuer une recherche par caractères génériques sur l’identité de toutes les annonces qui sont configurées pour l’organisation. Utilisez le caractère générique (*) pour filtrer n’importe quelle partie de l’identité.

LocalStore

Facultatif

Paramètre de commutateur

Extrait les données d’annonce à partir du réplica local du magasin central de gestion, et non du magasin central de gestion lui-même.

Types d’entrées

Aucun.

Types de retours

Retourne une ou plusieurs instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.AnnouncementServiceSettings.Announcement.

Exemple

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

Get-CsAnnouncement

L’exemple 1 retourne toutes les annonces configurées pour être utilisées dans l’organisation. Cette opération s’effectue en appelant Get-CsAnnouncement sans aucun paramètre.

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

Get-CsAnnouncement -Identity "ApplicationServer:redmond.litwareinc.com/1951f734-c80f-4fb2-965d-51807c792b90"

La commande précédente retourne une seule annonce : l’annonce dont l’identité est ApplicationServer:redmond.litwareinc.com/1951f734-c80f-4fb2-965d-51807c792b90. L’exemple 5 fournit un autre moyen (et sans doute plus simple) de récupérer une annonce spécifique.

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

Get-CsAnnouncement -Identity "ApplicationServer:redmond.litwareinc.com"

La commande présentée dans l’exemple 3 retourne des informations sur toutes les annonces qui ont été configurées pour être utilisées sur le service ApplicationServer:redmond.litwareinc.com.

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

Get-CsAnnouncement -Filter "*ApplicationServer:Redmond*"

Dans l’exemple 4, des informations sont retournées pour toutes les annonces configurées pour être utilisées sur le site Redmond (sur tous les domaines). Cette opération s’effectue en incluant le paramètre Filter et la valeur de filtre "*ApplicationServer:Redmond*", qui limite les données retournées aux annonces dont l’identité contient par la valeur de chaîne "ApplicationServer:Redmond". Par définition, il s’agit des annonces configurées pour être utilisées sur le site Redmond.

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

Get-CsAnnouncement | Where-Object {$_.Name -eq "Welcome Announcement"}

L’exemple 5 présente une autre méthode permettant de retourner une annonce spécifique ou un ensemble d’annonces particulier ; en l’occurrence, toutes les annonces nommées Welcome Announcement. Pour ce faire, Get-CsAnnouncement est d’abord appelée sans aucun paramètre, afin de retourner une collection de toutes les annonces utilisées dans l’organisation. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui sélectionne les annonces dont le nom est égal à (-eq) "Welcome Announcement".

-------------------------- Exemple 6 ------------------------

Get-CsAnnouncement -Identity "ApplicationServer:redmond.litwareinc.com" | Where-Object {$_.Name -eq "Welcome Announcement"}

L’exemple 6 est semblable à l’exemple 5, mais présente une autre manière de retourner une seule annonce. Nous appelons de nouveau Get-CsAnnouncement, mais nous spécifions cette fois l’identité ApplicationServer:redmond.litwareinc.com. Le système retourne ainsi une collection de toutes les annonces associées à ce service. Comme dans l’exemple 5, cette collection est ensuite redirigée vers la cmdlet Where-Object, qui sélectionne les annonces dont le nom est égal à (-eq) "Welcome Announcement". Puisque les noms d’annonce doivent être uniques dans un service d’application, cette commande retourne toujours un seul élément.

-------------------------- Exemple 7 ------------------------

Get-CsAnnouncement | Where-Object {$_.Name -like "Welcome*"}

Cet exemple est similaire à l’exemple 5. En effet, nous récupérons dans ce cas toutes les annonces, puis nous redirigeons cette collection vers la cmdlet Where-Object. Néanmoins, dans l’exemple 5, nous avons utilisé l’opérateur –eq dans la clause where pour rechercher une correspondance identique du nom. Dans cet exemple, nous avons utilisé l’opérateur –like et une valeur de caractère générique pour rechercher toutes les annonces qui, dans ce cas, commencent par la chaîne Welcome.

-------------------------- Exemple 8 ------------------------

Get-CsAnnouncement | Where-Object {($_.TextToSpeechPrompt -ne $Null) -and ($_.Language -ne "en-US")}

Dans l’exemple 8, des informations sont retournées pour toutes les annonces qui utilisent une invite vocale (en tant qu’annonce principale ou de remplacement pour un fichier audio) mais qui n’utilisent pas l’anglais U.S. comme langue. Pour effectuer cette tâche, la commande appelle d’abord Get-CsAnnouncement afin de retourner une collection de toutes les annonces actuellement configurées. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui sélectionne toutes les annonces dont la propriété TextToSpeechPrompt n’est pas vide (pas égale à $Null) et dont la propriété Language n’est pas égale à (-ne) en-US.