Remove-CsAnnouncement
Última modificación del tema: 2012-03-26
Quita un anuncio de Microsoft Lync Server 2010. Los anuncios se reproducen cuando los usuarios marcan un número de teléfono válido pero sin asignar. El anuncio puede ser un mensaje (como, "Este número está fuera de servicio temporalmente") o una señal de ocupado.
Sintaxis
Remove-CsAnnouncement -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Una organización puede disponer de números de teléfono que no estén asignados a usuarios o teléfonos, pero que son números válidos a los que se puede llamar. De forma predeterminada, cuando alguien marca uno de estos números, recibe una señal de ocupado y la llamada puede dar como resultado un error que se devuelve al cliente SIP. Aplicando configuraciones de anuncios a los números sin asignar, los administradores pueden reproducir un mensaje, devolver una señal de ocupado o redirigir la llamada. Este cmdlet quita una o varias de estas configuraciones de anuncios.
Si intenta quitar un anuncio asociado a un intervalo de números sin asignar, de forma predeterminada se le pedirá que confirme si desea quitar el anuncio. Si elimina el anuncio, la propiedad AnnouncementName del intervalo se mostrará como Null y no se reproducirá ningún anuncio cuando se llame a esos números, solo si se oye una señal de ocupado. Sin embargo, el valor de la propiedad AnnouncementId (GUID del anuncio quitado) se mantendrá visible.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdletRemove-CsAnnouncement de forma local: RTCUniversalServerAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluido cualquier otro rol RBAC personalizado que usted mismo haya creado), ejecute el siguiente comando desde Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsAnnouncement"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
Identidad Xds |
Identificador único del anuncio que desea quitar. El valor del parámetro Identity se puede indicar de dos formas: - Especificando la identidad (Identity) del Servicio de aplicaciones de los anuncios que quiera eliminar. De esta forma, se quitarán todos los anuncios que estén configurados con la identidad del servicio en cuestión. Por ejemplo, ApplicationServer:Redmond.litwareinc.com. - Especificando la identidad (Identity) completa del único anuncio que quiera quitar. Este valor siempre tendrá el formato <serviceID>/<GUID>, siendo serviceID la Identidad del servidor de aplicaciones que ejecuta el servicio de anuncio, y GUID un identificador único global asociado a dicho anuncio. Por ejemplo: ApplicationServer:Redmond.litwareinc.com/bef5fa3b-3c97-4af0-abe7-611deee7616c. |
Force |
Opcional |
Parámetro modificador |
Suprime las preguntas de confirmación que aparecerían antes de realizar cambios. |
WhatIf |
Opcional |
Parámetro modificador |
Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente. |
Confirm |
Opcional |
Parámetro modificador |
Solicita confirmación antes de ejecutar el comando. |
Tipos de entrada
Ninguno.
Tipos de valores devueltos
Elimina instancias existentes del objeto Microsoft.Rtc.Management.WritableConfig.Settings.AnnouncementServiceSettings.Announcement.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Remove-CsAnnouncement -Identity "ApplicationServer:Redmond.litwareinc.com/1951f734-c80f-4fb2-965d-51807c792b90"
El comando anterior quita el anuncio con Identidad "ApplicationServer:Redmond.litwareinc.com/1951f734-c80f-4fb2-965d-51807c792b90". Dado que las identidades deben ser únicas, este comando quitará, como máximo, un único anuncio.
-------------------------- Ejemplo 2 ------------------------
Remove-CsAnnouncement -Identity "ApplicationServer:Redmond.litwareinc.com"
En el Ejemplo 2 se eliminan todos los anuncios aplicados al servicio ApplicationServer:Redmond.litwareinc.com. Para ello, se llama a Remove-CsAnnouncement junto con el parámetro Identity. Cuando se especifica el valor de parámetro "ApplicationServer:Redmond.litwareinc.com" (sin el GUID añadido que identifica a un anuncio único), se quitan todos los anuncios configurados para el servicio especificado.