Compartilhar via

  • Artigo

Get-CsAnnouncement

 

Tópico modificado em: 2012-03-23

Retorna informações sobre os comunicados do Microsoft Lync Server 2010 configurados para uso na organização. Os comunicados são realizados 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

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

Get-CsAnnouncement [-Filter <String>] [-LocalStore <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 recupera uma ou várias dessas definições de comunicado.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Get-CsAnnouncement localmente: RTCUniversalUserAdmins, 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 "Get-CsAnnouncement"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

XdsIdentity

Um identificador do Comunicado que se deseja recuperar. Se você omitir esse parâmetro e o parâmetro Filter, serão exibidas todas as instâncias de comunicados configurados para a organização. O valor do parâmetro Identidade pode ser fornecido de uma das seguintes maneiras:

- digite a Identidade do Serviço de aplicativos dos comunicados que deseja recuperar. Isso irá recuperar todos os comunicados configurados com a Identidade de serviço determinada. Por exemplo, ApplicationServer:Redmond.litwareinc.com.

- Insira a Identidade completa do comunicado específico que deseja recuperar. Este valor sempre estará no formato <serviceID>/<GUID>, em que serviceID é a Identidade do Servidor de Aplicativos que executa o Serviço de Comunicado e GUID é um identificador globalmente exclusivo associado a este comunicado. Por exemplo: ApplicationServer:Redmond.litwareinc.com/bef5fa3b-3c97-4af0-abe7-611deee7616c.

Filter

Opcional

Cadeia de caracteres

Esse parâmetro permite realizar uma pesquisa de caractere curinga na Identidade de todos os comunicados configurados para a organização. Use o caractere curinga (*) para filtrar qualquer parte da Identidade.

LocalStore

Opcional

SwitchParameter

Recupera as informações do comunicado na réplica local do Repositório de Gerenciamento Central, em vez do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma.

Tipos de Retorno

Retorna uma ou várias instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.AnnouncementServiceSettings.Announcement.

Exemplo

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

Get-CsAnnouncement

O Exemplo 1 retorna todos os comunicados configurados para uso na organização. Isto é feito chamando-se Get-CsAnnouncement sem qualquer parâmetro.

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

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

O comando anterior retorna um único comunicado: o comunicado com a Identidade ApplicationServer:redmond.litwareinc.com/1951f734-c80f-4fb2-965d-51807c792b90. O Exemplo 5 oferece uma maneira diferente (e relativamente mais fácil) de recuperar um comunicado específico.

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

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

O comando exibido no Exemplo 3 retorna informações sobre todos os comunicados que tiverem sido configurados para uso no serviço ApplicationServer:redmond.litwareinc.com.

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

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

No Exemplo 4, retornam-se informações sobre todos os comunicados configurados para uso no site de Redmond (em todos os domínios). Esta tarefa é realizada incluindo-se o parâmetro Filter e o valor de filtro "*ApplicationServer:Redmond*", que limita os dados retornados aos comunicados que tiverem uma identidade que contenha o valor de cadeia de caracteres "ApplicationServer:Redmond". Por definição, esses são comunicados configurados para uso no site de Redmond.

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

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

O Exemplo 5 mostra uma maneira diferente de retornar um comunicado ou conjunto de comunicados específicos; nesse caso, todos os comunicados denominados Comunicado de Boas-Vindas. Para realizar isso, chama-se primeiramente Get-CsAnnouncement, sem nenhum parâmetro, para retornar uma coleção de todos os comunicados em uso na organização. Essa coleção será canalizada para o cmdlet Where-Object, que selecionará os comunicados que possuírem Name igual a (-eq) "Comunicado de Boas-Vindas".

-------------------------- Exemplo 6 ------------------------

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

O Exemplo 6 é semelhante ao Exemplo 5, mas esse exemplo mostra outra maneira de retornar um único comunicado. Chamamos novamente Get-CsAnnouncement, mas, dessa vez, especificamos a Identidade ApplicationServer:redmond.litwareinc.com. Isso retornará uma coleção de todos os comunicados associados a esse serviço. No Exemplo 5, essa coleção é canalizada para o cmdlet Where-Object, que seleciona os comunicados que possuírem Name igual a (-eq) "Comunicado de Boas-Vindas". Como os nomes de comunicados devem ser exclusivos em um Serviço de aplicativos, esse comando nunca retornará mais de um único item.

-------------------------- Exemplo 7 ------------------------

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

Esse exemplo é semelhante ao Exemplo 5, porque recuperamos todos os comunicados e, em seguida, canalizamos a coleção de comunicados para o cmdlet Where-Object. No entanto, no Exemplo 5, utilizamos o operador -eq na cláusula que especifica onde localizar uma correspondência idêntica ao nome. Nesse exemplo, usamos o operador -like e um valor de curinga para localizar todos os comunicados que, nesse caso, começarem com a cadeia de caracteres Welcome.

-------------------------- Exemplo 8 ------------------------

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

No Exemplo 8, retornam-se as informações referentes a todos os comunicados que utilizarem um prompt de texto em fala (TTS) (como o comunicado principal ou como um fallback para um arquivo de áudio), mas não utilizarem inglês norte-americano como idioma. Para realizar essa tarefa, o comando primeiramente chama Get-CsAnnouncement, para retornar uma coleção de todos os comunicados configurados. Essa coleção será então canalizada para o cmdlet Where-Object, que selecionará todos os comunicados cuja propriedade TextToSpeechPrompt não for vazia (não igual a $Null) e cuja propriedade Language não for igual (-ne) a en-US.