Remove-CsAnnouncement
Dernière rubrique modifiée : 2012-03-26
Supprime une annonce existante de Microsoft Lync Server 2010. 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
Remove-CsAnnouncement -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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 supprime un ou plusieurs paramètres d’annonce.
Si vous tentez de supprimer une annonce associée à une plage de numéros non attribués, vous recevez par défaut une invite vous demandant de confirmer votre suppression. Si vous supprimez l’annonce, la propriété AnnouncementName de la plage est définie sur Null et aucune annonce n’est émise quand ces numéros sont composés. Le seul son émis est celui d’un signal occupé. Toutefois, la valeur de la propriété AnnouncementId (GUID d’une annonce supprimée) reste visible.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Remove-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 "Remove-CsAnnouncement"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
XdsIdentity |
Identificateur unique de l’annonce que vous souhaitez supprimer. 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 supprimer. Cette action supprime toutes les annonces configurées avec l’identité de service fournie. Exemple : ApplicationServer:Redmond.litwareinc.com. - Entrez l’identité complète d’une seule annonce que vous souhaitez supprimer. Cette valeur sera toujours au format <serviceID>/<GUID>, où serviceID est la propriété Identity du serveur d’applications exécutant le service d’annonce ; GUID est l’identificateur global unique associé à ces paramètres d’annonce. Par exemple : ApplicationServer:Redmond.litwareinc.com/bef5fa3b-3c97-4af0-abe7-611deee7616c. |
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
Aucun.
Types de retours
Supprime les instances existantes de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.AnnouncementServiceSettings.Announcement.
Exemple
-------------------------- Exemple 1 ------------------------
Remove-CsAnnouncement -Identity "ApplicationServer:Redmond.litwareinc.com/1951f734-c80f-4fb2-965d-51807c792b90"
La commande ci-dessus supprime l’annonce dont l’identité est "ApplicationServer:Redmond.litwareinc.com/1951f734-c80f-4fb2-965d-51807c792b90". Les identités devant être uniques, cette commande supprime au maximum une seule annonce.
-------------------------- Exemple 2 ------------------------
Remove-CsAnnouncement -Identity "ApplicationServer:Redmond.litwareinc.com"
Dans l’exemple 2, toutes les annonces qui ont été appliquées au service ApplicationServer:Redmond.litwareinc.com sont supprimées. Pour ce faire, Remove-CsAnnouncement est appelée avec le paramètre Identity. Le fait de spécifier la valeur de paramètre "ApplicationServer:Redmond.litwareinc.com" (sans le GUID ajouté identifiant une annonce unique) supprime toutes les annonces configurées pour le service spécifié.