Compartir a través de

  • Artículo

Get-CsAnnouncement

 

Última modificación del tema: 2012-03-23

Devuelve información sobre los anuncios de Microsoft Lync Server 2010 configurados para el uso en una organización. Los anuncios se reproducen cuando los usuarios marcan un número de teléfono válido sin asignar. El anuncio puede ser un mensaje (como, "Este número está fuera de servicio temporalmente") o una señal de ocupado.

Sintaxis

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

Get-CsAnnouncement [-Filter <String>] [-LocalStore <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. Al aplicar la configuración de anuncios a números sin asignar, los administradores tienen la opción de reproducir un mensaje, devolver una señal de ocupado o redirigir la llamada. Este cmdlet recupera una o varias configuraciones de anuncios.

Quién puede ejecutar este cmdlet: de manera predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar localmente el cmdlet Get-CsAnnouncement: RTCUniversalUserAdmins, 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 "Get-CsAnnouncement"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Un identificador del anuncio que desea recuperar. Si omite este parámetro y el parámetro Filter, se mostrarán todas las instancias de anuncios configuradas para la organización. El valor del parámetro Identity se puede especificar de dos formas distintas:

- Especificando la identidad del Servicio de aplicaciones para los anuncios que desee recuperar. De este forma, se recuperará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 recuperar. Este valor siempre estará en el formato <serviceID>/<GUID>, donde serviceID es la identidad del servidor de aplicaciones que ejecuta el servicio de anuncio y GUID es un identificador único de forma global asociado con este anuncio. Por ejemplo: ApplicationServer:Redmond.litwareinc.com/bef5fa3b-3c97-4af0-abe7-611deee7616c.

Filter

Opcional

Cadena de caracteres

Este parámetro permite realizar una búsqueda con caracteres comodín en la identidad de todos los anuncios configurados para la organización. Use el carácter comodín (*) para filtrar cualquier parte de la identidad.

LocalStore

Opcional

Parámetro modificador

Recupera la información de anuncio de la réplica local del Almacén de administración central, en lugar de recuperarla del propio Almacén de administración central.

Tipos de entrada

Ninguno.

Tipos de valores devueltos

Devuelve una o más instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.AnnouncementServiceSettings.Announcement.

Ejemplo

-------------------------- Ejemplo 1 ------------------------

Get-CsAnnouncement

En el Ejemplo 1, se devuelven todos los anuncios configurados para su uso en la organización. Para ello, se llama a Get-CsAnnouncement sin parámetros.

-------------------------- Ejemplo 2 ------------------------

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

El comando anterior devuelve un solo anuncio: el anuncio con la identidad ApplicationServer:redmond.litwareinc.com/1951f734-c80f-4fb2-965d-51807c792b90. En el Ejemplo 5 se muestra una forma alternativa (y posiblemente más sencilla) de recuperar un anuncio específico.

-------------------------- Ejemplo 3 ------------------------

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

El comando mostrado en el Ejemplo 3 devuelve información sobre todos los anuncios que se hayan configurado para su uso en el servicio ApplicationServer:redmond.litwareinc.com.

-------------------------- Ejemplo 4 ------------------------

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

En el Ejemplo 4, se devuelve información para todos los anuncios configurados para su uso en el sitio de Redmond (en todos los dominios). Para ello, se incluye el parámetro Filter y el valor de filtro "*ApplicationServer:Redmond*", que restringe los datos devueltos a los anuncios que tengan un valor de Identity que contenga el valor de cadena de caracteres "ApplicationServer:Redmond". Por definición, se trata de anuncios configurados para su uso en el sitio de Redmond.

-------------------------- Ejemplo 5 ------------------------

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

En el Ejemplo 5 se muestra una forma alternativa de devolver un anuncio o un conjunto de anuncios específicos; en este caso, todos los anuncios llamados Welcome Announcement. Para ello, primero se llama a Get-CsAnnouncement sin ningún parámetro para devolver una colección de todos los anuncios que están en uso en la organización. A continuación, esta colección se transfiere al cmdlet Where-Object, que selecciona los anuncios que tengan un valor de Name igual a (-eq) "Welcome Announcement".

-------------------------- Ejemplo 6 ------------------------

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

El Ejemplo 6 es similar al Ejemplo 5, pero este ejemplo muestra otra forma de devolver un solo anuncio. Volvemos a llamar a Get-CsAnnouncement, pero esta vez especificamos el valor de Identity ApplicationServer:redmond.litwareinc.com. De esta forma, se devuelve una colección de todos los anuncios asociados con el servicio. Como en el Ejemplo 5, esta colección se transfiere al cmdlet Where-Object, que selecciona los anuncios que tengan un valor de Name igual a (-eq) "Welcome Announcement". Puesto que los nombres de anuncio deben ser únicos dentro de un mismo Servicio de aplicaciones, este comando nunca devolverá más de un elemento.

-------------------------- Ejemplo 7 ------------------------

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

Este ejemplo es parecido al Ejemplo 5 en el sentido que se recuperan todos los anuncios y, a continuación, se transfiere la colección de anuncios al cmdlet Where-Object. Sin embargo, en el Ejemplo 5 hemos usado el operador –eq en la cláusula where para encontrar una coincidencia exacta del nombre. En este ejemplo hemos usado el operador –like y un valor comodín para buscar todos los anuncios que, en este caso, empiecen por la cadena Welcome.

-------------------------- Ejemplo 8 ------------------------

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

En el Ejemplo 8, se devuelve información de todos los anuncios que usan una indicación de texto a voz (TTX), ya sea el anuncio principal o como alternativa a un archivo de audio, pero no utiliza el inglés de EE.UU. como idioma. Para ello, el comando primero llama a Get-CsAnnouncement para devolver una colección de todos los anuncios que están actualmente configurados. A continuación, esta colección se transfiere al cmdlet Where-Object, que selecciona todos los anuncios cuya propiedad TextToSpeechPrompt no esté vacía (no sea igual a $Null) y cuya propiedad Language no sea igual a (-ne) en-US.