Compartilhar via

  • Artigo

New-CsAnnouncement

 

Tópico modificado em: 2012-03-23

Cria um novo comunicado do Microsoft Lync Server 2010. Comunicados são reproduzidos quando usuários discam um número de telefone válido mas não atribuído. Um comunicado pode ser uma mensagem (como "Este número está temporariamente inoperante") ou um sinal de ocupado.

Sintaxe

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

Descrição Detalhada

Uma organização pode possuir números de telefone que que não sejam atribuídos a usuários ou telefones, mas que ainda assim sejam números válidos que possam ser chamados. Como padrão, quando um destes números é discado, um sinal de ocupado é recebido e a chamada pode retornar um erro para o cliente SIP. Através da seleção de opções de comunicado para números não atribuídos, administradores têm a opção de reproduzir uma mensagem, retornar um sinal de ocupado ou redirecionar o chamado. Este cmdlet cria essas configurações de comunicado.

Você pode atribuir comunicados a números não atribuídos chamando o cmdlet New-CsUnassignedNumber ou Set-CsUnassignedNumber.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet New-CsAnnouncement localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

Xds Identity

Um identificador exclusivo para o comunicado. Para este valor, você deve digitar a identidade do Servidor de Aplicativos que está executando o aplicativo de Grupo de Resposta. Por exemplo, ApplicationServer:redmond.litwareinc.com.

Mais de um Comunicado pode ser atribuído a um único serviço. Portanto, e para que a Identidade seja um valor exclusivo, um GUID (identificador global exclusivo) será automaticamente gerado e atribuído à Identidade quando o comunicado for criado. Um novo comunicado terá uma identidade no formato service:<ID do serviço>/<GUID>. Por exemplo: service: ApplicationServer:redmond.litwareinc.com/bef5fa3b-3c97-4af0-abe7-611deee7616c. Não é necessário fornecer um GUID ao chamar este cmdlet. Em vez disso, forneça apenas a Identidade do serviço e o GUID será gerado automaticamente e adicionado à Identidade.

Embora não seja necessário fornecer um GUID, você pode fazê-lo. Você pode querer fazer isso se um comunicado tiver sido atribuído a um intervalo de números não atribuídos e depois tiver sido eliminado. Você pode criar um novo comunicado com uma identidade de correspondência (incluindo o GUID), não tendo neste caso que atualizar o intervalo de números não atribuídos.

Parent

Opcional

Cadeia de caracteres

Este parâmetro é igual à Identidade, com exceção do fato de que a Identidade irá aceitar a Identidade do serviço e o GUID, enquanto Parent aceitará somente a Identidade do serviço; o GUID será gerado automaticamente. Você não pode especificar um Identity e um Parent.

Name

Obrigatório

Cadeia de caracteres

Um nome que descreva o Comunicado. Este nome deve ser exclusivo dentro do serviço. Este nome será utilizado na chamada a New-CsUnassignedNumber ou Set-CsUnassignedNumber para especificar o Comunicado associado a um intervalo de números não atribuídos.

AudioFilePrompt

Opcional

Cadeia de caracteres

O nome do arquivo de áudio a ser reproduzido para o Comunicado. Arquivos de áudio são guardados no Repositório de Arquivos. Utilize o cmdlet Import-CsAnnouncementFile para salvar um arquivo de áudio no Repositório de Arquivos.

Tipos de arquivo válidos: WAV e WMA

Language

Opcional

Cadeia de caracteres

O idioma no qual o prompt TTS (conversão de texto em fala) será reproduzido. Este parâmetro é obrigatório se um valor for inserido para TextToSpeechPrompt.

Digitam-se os valores como uma cadeia de caracteres, representando o idioma e a localidade a serem utilizados. A seguir, encontra-se uma lista de valores válidos, seguidos do idioma e da localidade entre parênteses: ca-ES (Catalão, Catalão); da-DK (Dinamarquês, Dinamarca); de-DE (Alemão, Alemanha); en-AU (Inglês, Austrália); en-CA (Inglês, Canadá); en-GB (Inglês, Reino Unido); en-IN (Inglês, Índia); en-US (Inglês, Estados Unidos); es-ES (Espanhol, Espanha); es-MX (Espanhol, México); fi-FI (Finlandês, Finlândia); fr-CA (Francês, Canadá); fr-FR (Francês, França); it-IT (Italiano, Itália); ja-JP (Japonês, Japão); ko-KR (Coreano, Coreia); nb-NO (Norueguês, Bokmal, Noruega); nl-NL (Holandês, Países Baixos); pl-PL (Polonês, Polônia); pt-BR (Português, Brasil); pt-PT (Português, Portugal); ru-RU (Russo, Rússia); sv-SE (Sueco, Suécia); zh-CN (Chinês, República Popular da China); zh-HK (Chinês, RAE de Hong Kong); zh-TW (Chinês, Taiwan)

TargetUri

Opcional

Cadeia de caracteres

O URI para o qual o chamador será transferido após o comunicado ser reproduzido. Este valor deve ser um endereço SIP inserido no formato sip: seguido pelo endereço SIP. Por exemplo, sip:kmyer@litwareinc.com. Observe que o endereço SIP pode também ser um número de telefone ou caixa postal como, por exemplo, sip:+14255551212@litwareinc.com;user=phone, para um número de telefone, ou sip:kmyer@litwareinc.com;opaque=app:voicemail, para caixa postal.

TextToSpeechPrompt

Opcional

Cadeia de caracteres

Um prompt de texto para fala (TTS). Esta é a cadeia de caracteres que será convertida para áudio e reproduzida como o comunicado.

Caso tanto AudioFilePrompt como TextToSpeechPrompt sejam especificados para um único comunicado, você receberá um aviso de que o arquivo de áudio terá precedência sobre o prompt TTS, que será ignorado.

Force

Opcional

SwitchParameter

Suprime a exibição de qualquer prompt de confirmação que de outra forma seria exibido antes de se efetuar alterações.

InMemory

Opcional

Parâmetro de opção

Cria uma referência de objeto, sem na verdade executar o objeto como uma alteração permanente. Se a saída deste cmdlet for atribuída, chamando-o com este parâmetro a uma variável, você poderá realizar alterações às propriedades da referência do objeto e executar estas alterações, chamando-se o cmdlet coincidente Set- deste cmdlet.

WhatIf

Opcional

Parâmetro de opção

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Parâmetro de opção

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Nenhuma.

Tipos de Retorno

Cria um objeto do tipo Microsoft.Rtc.Management.WritableConfig.Settings.AnnouncementServiceSettings.Announcement.

Exemplo

-------------------------- Exemplo 1 ------------------------

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

O Exemplo 1 mostra como criar um novo comunicado que irá reproduzir um prompt TTS em inglês dos Estados Unidos. O primeiro parâmetro que especificamos é a Identidade. Identity deve estar no escopo do serviço seguido do ID do serviço do Servidor de Aplicativos (ApplicationServer:redmond.litwareinc.com). Em seguida, atribui-se um nome para o comunicado, neste caso, Comunicado do Suporte Técnico. Para atribuir um prompt TTS a este comunicado, utilizamos o parâmetro TextToSpeechPrompt seguido de uma cadeia de caracteres com o texto do comunicado. Quando um prompt TTS é utilizado para um comunicado, o idioma deve ser especificado, o que é feito aqui através da inclusão do parâmetro Language seguido de uma cadeia de caracteres representando o inglês dos Estados Unidos (en-US).

Observe que as identidades de comunicados são compostas de duas partes: o serviço onde o comunicado deverá ser armazenado e um GUID (identificador global exclusivo) de 36 caracteres. Você verá a identidade completa após criar o novo comunicado; o GUID será gerado e aplicado automaticamente. Esta identidade será semelhante a: service:ApplicationServer:redmond.litwareinc.com/1951f734-c80f-4fb2-965d-51807c792b90.

-------------------------- Exemplo 2 ------------------------

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

O Exemplo 2 is semelhante ao Exemplo 1 em relação ao fato de iniciar pela inserção dos parâmetros requeridos, a saber, Identity e Name. Neste exemplo, entretanto, deseja-se que o comunicado reproduza um arquivo de áudio em vez de um prompt TTS. Para fazê-lo, deve-se incluir o parâmetro AudioFilePrompt com a cadeia de caracteres que contém o nome do arquivo de áudio (WelcomeMessage.wav). Este arquivo deve estar no Repositório de Arquivos para que o comunicado seja reproduzido. Os arquivos de áudio podem ser adicionados ao Repositório de Arquivos com o cmdlet Import-CsAnnouncementFile.

-------------------------- Exemplo 3 ------------------------

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

Como no Exemplo 2, este exemplo cria um comunicado que reproduz um arquivo de áudio quando o número é encontrado. Entretanto, neste exemplo, o parâmetro TargetUri também é especificado, adicionalmente aos parâmetros Identity, Name e AudioFilePrompt. Neste parâmetro é informado o URI do SIP do usuário ou do telefone para o qual o chamador será encaminhado após o comunicado ter sido reproduzido.

-------------------------- Exemplo 4 ------------------------

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

O Exemplo 4 é idêntico ao Exemplo 3, exceto pelo fato de encaminhar a chamada para um número de telefone, em vez de usar como base o endereço SIP do usuário.

-------------------------- Exemplo 5 ------------------------

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

Neste exemplo não se especifica um prompt ou um URI de destino, somente uma identidade e um nome. Isto significa que o chamador escutará um sinal de ocupado quando um chamado for efetuado para um número não atribuído associado a este comunicado.