Compartir a través de

  • Artículo

Set-CsAnnouncement

 

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

Modifica los valores de propiedad de un anuncio de Microsoft Lync Server 2010 existente. Los anuncios se reproducen cuando los usuarios marcan un número de teléfono válido pero sin asignar. Un anuncio puede ser un mensaje (como "Este número está fuera de servicio temporalmente") o una señal de ocupado.

Sintaxis

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>]]

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 modifica estas configuraciones de anuncios.

Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Set-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 "Set-CsAnnouncement"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Identificador único del anuncio. Este valor estará siempre 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 global asociado a dichas configuraciones de anuncios. Por ejemplo: ApplicationServer:redmond.litwareinc.com/bef5fa3b-3c97-4af0-abe7-611deee7616c.

Como puede resultar difícil introducir correctamente los GUID en la línea de comandos, le recomendamos que recupere los anuncios con el cmdlet Get-CsAnnouncement y los transfiera al cmdlet Set-CsAnnouncement para modificarlos. (Consulte la sección Ejemplos para obtener detalles.)

Instance

Opcional

Announcement

Referencia al objeto Announcement que quiere cambiar. Este objeto debe ser de tipo Microsoft.Rtc.Management.WritableConfig.Settings.AnnouncementServiceSettings.Announcement, que puede recuperarse llamando al cmdlet Get-CsAnnouncement.

Name

Opcional

Cadena de caracteres

Introduzca un valor para este parámetro para cambiar el nombre del anuncio. Los nombres deben ser únicos dentro de un servicio.

AudioFilePrompt

Opcional

Cadena de caracteres

El nombre del archivo de audio que se reproducirá para el anuncio. Los archivos de audio se almacenan en el Almacén de archivos. Para guardar un archivo de audio en el Almacén de archivos, use el cmdlet Import-CsAnnouncementFile.

Tipos de archivo válidos: WAV y WMA

TextToSpeechPrompt

Opcional

Cadena de caracteres

Una solicitud de texto a voz (TTS). Se trata de una cadena que se convertirá en audio y se reproducirá como anuncio.

Si tanto AudioFilePrompt como TextToSpeechPrompt se especifican para un único anuncio, recibirá una advertencia de que el archivo de audio tendrá prioridad y el aviso TTS se ignorará.

Language

Opcional

Cadena de caracteres

El idioma en el que se reproducirá la solicitud de TTS. Si se introduce un valor para TextToSpeechPrompt, este parámetro es obligatorio.

Los valores se introducen como una cadena de caracteres que representa el idioma y la configuración regional que se utilizarán. A continuación se muestra una lista de valores válidos, seguida por el idioma y la configuración regional entre paréntesis: ca-ES (catalán, Cataluña); da-DK (danés, Dinamarca); de-DE (alemán, Alemania); en-AU (inglés, Australia); en-CA (inglés, Canadá); en-GB (inglés, Reino Unido); en-IN (inglés, India); en-US (inglés, Estados Unidos); es-ES (español, España); es-MX (español, México); fi-FI (finés, Finlandia); fr-CA (francés, Canadá); fr-FR (francés, Francia); it-IT (italiano, Italia); ja-JP (japonés, Japón); ko-KR (coreano, Corea); nb-NO (noruego, Bokmål, Noruega); nl-NL (holandés, Países Bajos); pl-PL (polaco, Polonia); pt-BR (portugués, Brasil); pt-PT (portugués, Portugal); ru-RU (ruso, Rusia); sv-SE (sueco, Suecia); zh-CN (chino, República Popular China); zh-HK (chino, Hong Kong RAE); zh-TW (chino, Taiwán)

TargetUri

Opcional

Cadena de caracteres

El URI al que se transferirá el autor de la llamada una vez reproducido el anuncio. Este valor debe ser una dirección SIP introducida en formato sip: seguido de la dirección SIP. Por ejemplo, sip:kmyer@litwareinc.com. Tenga en cuenta que la dirección SIP también puede ser un número de teléfono o un correo de voz, por ejemplo, sip:+14255551212@litwareinc.com;user=phone para un número de teléfono o sip:kmyer@litwareinc.com;opaque=app:voicemail para un correo de voz.

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

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.AnnouncementServiceSettings.Announcement. Acepta la entrada transferida de objetos de anuncio.

Tipos de valores devueltos

Set-CsAnnouncement no devuelve ningún objeto ni valor. En su lugar, el cmdlet modifica instancias existentes del objeto Microsoft.Rtc.Management.WritableConfig.Settings.AnnouncementServiceSettings.Announcement.

Ejemplo

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

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

El comando que se muestra en el Ejemplo 1 asigna un nuevo archivo de audio al anuncio de Soporte técnico. Para realizar esta tarea, el comando usa en primer lugar Get-CsAnnouncement (sin ningún parámetro) para devolver una colección de todos los anuncios actualmente disponibles. A continuación, esta colección se transfiere al cmdlet Where-Object, que selecciona el único anuncio donde Name es igual a (-eq) "Help Desk Announcement". A su vez, dicho anuncio se transfiere a Set-CsAnnouncement, que establece el valor de la propiedad AudioFilePrompt en helpdesk.wav.

Tenga en cuenta que si este anuncio le ha asignado ya un valor TextToSpeechPrompt, este comando generará una advertencia de que se ignorará el valor de TextToSpeechPrompt.

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

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

En el ejemplo 2, la propiedad TextToSpeechPrompt para el anuncio Help Desk Announcement está establecida en Null, lo que borra en efecto el valor de la propiedad. Para ello, el comando utiliza primero Get-CsAnnouncement para devolver una colección de todos los anuncios disponibles actualmente. A continuación, esta colección se transfiere a Where-Object, que selecciona el anuncio donde el Nombre es igual a (-eq) "Help Desk Announcement". A continuación, este anuncio se transfiere al cmdlet Set-CsAnnouncement, que establece la propiedad TextToSpeechPrompt en un valor Null ($Null).

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

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

En este ejemplo se actualiza el TargetUri para el Anuncio con el nombre Help Desk Announcement. El comando utiliza primero Get-CsAnnouncement para devolver una colección de todos los anuncios disponibles actualmente. A continuación, esta colección se transfiere a Where-Object, que selecciona el anuncio donde el Nombre es igual a (-eq) "Help Desk Announcement". A continuación, este anuncio se transfiere al cmdlet Set-CsAnnouncement, que establece la propiedad TargetUri en una ubicación de correo de voz (sip:kmyer@litwareinc.com;opaque=app:voicemail).