Compartir a través de

  • Artículo

New-CsAnnouncement

 

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

Crea un nuevo 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. Un anuncio puede ser un mensaje (como "Este número está fuera de servicio temporalmente") o una señal de ocupado.

Sintaxis

New-CsAnnouncement -Identity <XdsIdentity> -Name <String> [-AudioFilePrompt <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Language <String>] [-TargetUri <String>] [-TextToSpeechPrompt <String>] [-WhatIf [<SwitchParameter>]]

New-CsAnnouncement -Name <String> -Parent <String> [-AudioFilePrompt <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Language <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 esa persona 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 crea la configuración de anuncios.

Puede asignar anuncios a números sin asignar llamando al cmdlet New-CsUnassignedNumber o Set-CsUnassignedNumber.

Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet New-CsAnnouncement localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsAnnouncement"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

Identificador único del anuncio. Para este valor, debe ingresar el Identity del Servidor de aplicaciones que ejecuta la aplicación Grupo de respuesta. Por ejemplo, ApplicationServer:redmond.litwareinc.com.

Es posible asignar más de un Anuncio a un único dispositivo. Por lo tanto, para hacer que Identity sea un valor único, automáticamente se generará un identificador único global (GUID) y se asignará a Identity cuando usted cree el Anuncio. El nuevo Anuncio tendrá una identidad en el servicio de formato:<Id. de servicio>/<GUID>. Por ejemplo: service: ApplicationServer:redmond.litwareinc.com/bef5fa3b-3c97-4af0-abe7-611deee7616c. No es necesario suministrar un GUID al llamar a este cmdlet. En su lugar, proporcione el Identity de servicio, y el GUID se generará y se agregará automáticamente al Identity.

No es necesario que proporcione un GUID, pero puede hacerlo. Es posible que desee hacer esto si un anuncio se asignó a un intervalo numérico sin asignar y, luego, se eliminó. Puede crear un nuevo anuncio con un Identity coincidente (incluido el GUID). En ese caso, no deberá actualizar el intervalo numérico sin asignar.

Parent

Opcional

Cadena de caracteres

Este parámetro es idéntico a Identity, excepto que Identity aceptará el Identity de servicio y el GUID, mientras que Parent aceptará únicamente el Identity de servicio; el GUID se generará automáticamente. No puede especificarse un valor para Identity y para Parent.

Name

Requerido

Cadena de caracteres

Nombre descriptivo del anuncio. Este nombre debe ser único en el servicio. Este nombre se usará en la llamada a New-CsUnassignedNumber o Set-CsUnassignedNumber para especificar el Anuncio asociado con el intervalo numérico sin asignar.

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 válidos de archivos: WAV y WMA

Language

Opcional

Cadena de caracteres

El idioma en el que se reproducirá el aviso de texto de voz (TTS). Si se escribe un valor para TextToSpeechPrompt, este parámetro es obligatorio.

Los valores se escriben como una cadena de caracteres que representa el idioma y la configuración regional que se usará. 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 cual será transferido el autor de la llamada después de que el anuncio se haya reproducido. Este valor debe ser una dirección SIP ingresada en el 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 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.

TextToSpeechPrompt

Opcional

Cadena de caracteres

Un aviso de texto a voz (TTS). Esta es una cadena de caracteres que se convertirá a audio y se reproducirá como anuncio.

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

Force

Opcional

Parámetro modificador

Suprime las solicitudes de confirmación que, de lo contrario, se mostrarían antes de realizar cambios.

InMemory

Opcional

Parámetro modificador

Crea una referencia de objeto sin confirmar realmente el objeto como cambio permanente. Si se asigna la salida de este cmdlet llamado con este parámetro en una variable, puede realizar cambios en las propiedades de la referencia del objeto y después confirmar estos cambios, llamando a este conjunto coincidente de cmdlet, - cmdlet.

WhatIf

Opcional

Parámetro modificador

Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente.

Confirm

Parámetro modificador

Solicita confirmación antes de ejecutar el comando.

Tipos de entrada

Ninguno.

Tipos de valores devueltos

Crea un objeto de tipo Microsoft.Rtc.Management.WritableConfig.Settings.AnnouncementServiceSettings.Announcement.

Ejemplo

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

New-CsAnnouncement -Identity ApplicationServer:redmond.litwareinc.com -Name "Help Desk Announcement" -TextToSpeechPrompt "Welcome to the Help Desk." -Language "en-US"

En el ejemplo 1, se demuestra cómo puede crear un anuncio nuevo que reproducirá un aviso TTS en inglés de EE. UU. El primer parámetro especificado es Identity. Identity debe estar en un ámbito de servicio, seguido de un Id. de servicio del Servidor de aplicaciones (ApplicationServer:redmond.litwareinc.com). A continuación, el anuncio recibe un Nombre, en este caso Anuncio de soporte técnico. Para asignar un aviso TTS a este anuncio, se usa el parámetro TextToSpeechPrompt seguido de una cadena con el texto del anuncio. Cuando se usa un aviso TTS para un anuncio, se debe especificar un idioma, lo cual se realiza al incluir el parámetro Language seguido de una cadena que represente inglés de EE. UU. (en-US).

Observe que las identidades del anunció están compuestas de dos partes: el servicio en donde se va a almacenar el anuncio y un GUID (identificador único global) de 36 caracteres. Verá el parámetro Identity completo una vez creado el anuncio nuevo y cuando se genera y se aplica el GUID de manera automática. Ese parámetro Identity será similar a esto: service:ApplicationServer:redmond.litwareinc.com/1951f734-c80f-4fb2-965d-51807c792b90.

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

New-CsAnnouncement -Identity ApplicationServer:redmond.litwareinc.com -Name "Welcome Announcement" -AudioFilePrompt "WelcomeMessage.wav"

El Ejemplo 2 es similar al Ejemplo 1 ya que se comienza al ingresar los parámetros requeridos, Identity y Name. Sin embargo, en este ejemplo, en lugar de que el anuncio reproduzca un anuncio TTS, se desea que reproduzca un archivo de audio. Para esto, se incluye el parámetro AudioFilePrompt y se le pasa una cadena que contiene el nombre del archivo de audio (WelcomeMessage.wav). Para que este anuncio pueda reproducirlo, este archivo debe estar en el Almacén de archivos. Puede agregar archivos de audio al Almacén de archivos al llamar al cmdlet Import-CsAnnouncementFile.

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

New-CsAnnouncement -Identity ApplicationServer:redmond.litwareinc.com -Name "Forward Announcement" -AudioFilePrompt "WelcomeMessage.wav" -TargetUri sip:kmyer@litwareinc.com

Al igual que en el Ejemplo 2, en este ejemplo se crea un anuncio que reproduce un archivo de audio cuando se alcanza el número. Sin embargo, en este ejemplo, además de los parámetros Identity, Name y AudioFilePrompt, también se especifica el parámetro TargetUri. A este parámetro se le pasa el URI del SIP del usuario o teléfono al cual el autor de la llamada será desviado después de que se haya reproducido el anuncio.

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

New-CsAnnouncement -Identity ApplicationServer:redmond.litwareinc.com -Name "Forward Announcement" -AudioFilePrompt "WelcomeMessage.wav" -TargetUri "sip:+14255551212@litwareinc.com;user=phone"

El Ejemplo 4 es idéntico al Ejemplo 3, salvo que, en lugar de que se desvíe la llamada según la dirección SIP de un usuario, la llamada se desvía a un número de teléfono.

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

New-CsAnnouncement -Identity ApplicationServer:redmond.litwareinc.com -Name "Busy"

En este ejemplo, no se especifica un aviso o un URI de destino, solo se incluye un Identity y un Name. Esto significa que el autor de la llamada escuchará una señal de ocupado cuando se conecta una llamada a un número sin asignar asociado a este anuncio.