Compartilhar via

  • Artigo

Set-CsAnnouncement

 

Tópico modificado em: 2012-03-26

Modifica os valores de propriedade de um comunicado Microsoft Lync Server 2010 existente. Os comunicados são reproduzidos quando os usuários discam um número de telefone válido, mas não atribuído. Um comunicado pode ser uma mensagem (como "Esse número está temporariamente fora de serviço") ou um sinal de ocupado.

Sintaxe

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

Descrição Detalhada

É possível que uma organização tenha números de telefone não atribuídos a usuários ou telefones, mas que ainda assim sejam válidos e possam ser chamados. Por padrão, quando alguém disca um destes números de telefone, receberá um sinal de ocupado e a chamada poderá resultar em um erro retornado ao cliente SIP. Ao aplicar definições de comunicados a números não atribuídos, os administradores têm a opção de reproduzir uma mensagem, retornar um sinal de ocupado ou redirecionar a chamada. Este cmdlet modifica essas definições de comunicados.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Set-CsAnnouncement localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet tiver sido atribuído (inclusive qualquer função RBAC personalizada que tiver sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

Identidade de Xds

Um identificador exclusivo para o comunicado. Este valor sempre estará no formato <serviceID>/<GUID>, onde serviceID é a identidade do Servidor de aplicativos que executa o serviço de comunicado e GUID é um identificador globalmente exclusivo associado a estas definições de comunicado. Por exemplo: ApplicationServer:redmond.litwareinc.com/bef5fa3b-3c97-4af0-abe7-611deee7616c.

Como os GUIDs podem ser difíceis de se digitar na linha de comando, na maioria das vezes os comunicados serão recuperados utilizando-se o cmdlet Get-CsAnnouncement e canalizando-os para o cmdlet Set-CsAnnouncement, para modificação (para obter mais detalhes, consulte a seção Exemplos).

Instance

Opcional

Comunicado

Uma referência para o objeto de comunicado que se quer alterar. Este objeto deve ser do tipo Microsoft.Rtc.Management.WritableConfig.Settings.AnnouncementServiceSettings.Announcement, que pode ser recuperado chamando-se o cmdlet Get-CsAnnouncement.

Name

Opcional

Cadeia de caracteres

Digite um valor para este parâmetro, para mudar o nome do comunicado. Os nomes devem ser exclusivos dentro de um serviço.

AudioFilePrompt

Opcional

Cadeia de caracteres

O nome do arquivo de áudio a ser reproduzido no comunicado. Os arquivos de áudio são armazenados no Repositório de Arquivos Para salvar um arquivo de áudio no Repositório de Arquivos, utilize o cmdlet Import-CsAnnouncementFile.

Tipos de arquivos válidos: WAV e WMA

TextToSpeechPrompt

Opcional

Cadeia de caracteres

Um prompt de texto-para-fala (TTS). Esta é uma cadeia de caracteres que será convertida em áudio e reproduzida como 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.

Language

Opcional

Cadeia de caracteres

O idioma no qual o prompt TTS será reproduzido. Se for digitado o valor de TextToSpeechPrompt, este parâmetro será obrigatório.

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 ao qual o chamador será transferido após o comunicado ter sido reproduzido. Este valor deve ser um endereço SIP digitado no formato sip: seguido do endereço SIP. Por exemplo: sip:kmyer@litwareinc.com. Observe que o endereço SIP também pode ser um número de telefone ou correio de voz como, por exemplo, sip:+14255551212@litwareinc.com;user=phone (número de telefone) ou sip:kmyer@litwareinc.com;opaque=app:voicemail (mensagem de voz).

Force

Opcional

SwitchParameter

Suprime qualquer aviso de confirmação que, de outra maneira, seria exibido antes de se realizar as alterações.

WhatIf

Opcional

Parâmetro de opção

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

Confirm

Opcional

Parâmetro de opção

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

Tipos de Entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.AnnouncementServiceSettings.Announcement. Aceita entrada canalizada dos objetos de comunicado.

Tipos de Retorno

Set-CsAnnouncement não retorna qualquer objeto ou valor. Em vez disso, o cmdlet modifica instâncias existentes do objeto Microsoft.Rtc.Management.WritableConfig.Settings.AnnouncementServiceSettings.Announcement.

Exemplo

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

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

O comando mostrado no Exemplo 1 atribui um novo arquivo de áudio ao comunicado da Assistência Técnica. Para realizar esta tarefa, o comando utiliza inicialmente Get-CsAnnouncement, sem qualquer parâmetro, para retornar uma coleção de todos os comunicados disponíveis. Esta coleção será então canalizada para o cmdlet Where-Object, que selecionará um comunicado cujo Name for igual a (-eq) "Comunicado da Assistência Técnica". Por sua vez, esse comunicado será canalizado para Set-CsAnnouncement, que definirá o valor da propriedade AudioFilePrompt como helpdesk.wav.

Observe que se este comunicado já possuir um valor de TextToSpeechPrompt atribuído a ele, este comando gerará um aviso, informando que o valor de TextToSpeechPrompt será ignorado.

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

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

No Exemplo 2, define-se a propriedade TextToSpeechPrompt do Comunicado da Assistência Técnica com um valor nulo; isto efetivamente apaga o valor da propriedade. Para fazer isso, o comando primeiramente usa Get-CsAnnouncement, para retornar uma coleção de todos os comunicados disponíveis. Esta coleção será então canalizada para Where-Object, que selecionará o comunicado cujo Name for igual a (-eq) "Comunicado da Assistência Técnica". Este comunicado será então canalizado para o cmdlet Set-CsAnnouncement, que definirá a propriedade TextToSpeechPrompt com um valor nulo ($Null).

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

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

Este exemplo atualiza TargetUri do comunicado intitulado Comunicado da Assistência Técnica. O comando primeiramente utiliza Get-CsAnnouncement, para retornar uma coleção de todos os comunicados disponíveis. Esta coleção será então canalizada para Where-Object, que selecionará o comunicado cujo Name for igual a (-eq) "Comunicado da Assistência Técnica". Este comunicado será então canalizado para o cmdlet Set-CsAnnouncement, que definirá a propriedade TargetUri como um local de correio de voz (sip:kmyer@litwareinc.com;opaque=app:voicemail).