Remove-CsAnnouncement
Tópico modificado em: 2012-03-26
Remove um comunicado existente do Microsoft Lync Server 2010. 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
Remove-CsAnnouncement -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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 remove uma ou várias dessas definições de comunicado.
Se você tentar remover um comunicado que esteja associado a um intervalo numérico não atribuído, por padrão receberá um aviso perguntando se realmente deseja remover o comunicado. Se você excluir o comunicado, a propriedade AnnouncementName deste intervalo será exibida como Null e nenhum comunicado será feito quando esses números forem acessados, e apenas um sinal de ocupado será ouvido. No entanto, o valor da propriedade AnnouncementId (o GUID do Comunicado que foi removido) permanecerá visível.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Remove-CsAnnouncement localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do controle de acesso baseado em função (RBAC) que receberam a atribuição desse cmdlet (incluindo qualquer função RBAC personalizada criada por você), execute o seguinte comando do prompt Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsAnnouncement"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
XdsIdentity |
Um identificador exclusivo do Comunicado que você deseja remover. O valor do parâmetro Identidade pode ser fornecido de uma das seguintes maneiras: - insira a Identidade do Serviço de aplicativos correspondente aos comunicados que deseja remover. Isso irá remover 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 remover. 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. |
Force |
Opcional |
SwitchParameter |
Suprime qualquer aviso de confirmação que, de outra maneira, seria exibido antes de realizar 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
Nenhuma.
Tipos de Retorno
Exclui instâncias existentes do objeto Microsoft.Rtc.Management.WritableConfig.Settings.AnnouncementServiceSettings.Announcement.
Exemplo
-------------------------- Exemplo 1 ------------------------
Remove-CsAnnouncement -Identity "ApplicationServer:Redmond.litwareinc.com/1951f734-c80f-4fb2-965d-51807c792b90"
O comando precedente remove o comunicado cuja Identidade for "ApplicationServer:Redmond.litwareinc.com/1951f734-c80f-4fb2-965d-51807c792b90". Como as identidades devem ser exclusivas, este comando removerá, no máximo, um único comunicado.
-------------------------- Exemplo 2 ------------------------
Remove-CsAnnouncement -Identity "ApplicationServer:Redmond.litwareinc.com"
No Exemplo 2, todos os comunicados que tiverem sido aplicados ao serviço ApplicationServer:Redmond.litwareinc.com serão excluídos. Para tal, chama-se Remove-CsAnnouncement, juntamente com o parâmetro Identity. A especificação do valor de parâmetro "ApplicationServer:Redmond.litwareinc.com" (sem o GUID anexo que identifica um comunicado exclusivo) removerá todos os comunicados configurados para o serviço especificado.