Compartilhar via

  • Artigo

Remove-CsDialInConferencingDtmfConfiguration

 

Tópico modificado em: 2012-03-26

Remove uma coleção existente de definições de sinalização DTMF (multifrequência de tom dual) usada para conferência discada. A DTMF permite que os usuários que discam para uma conferência controlem as definições da conferência (como ativar e desativar o mudo, ou bloquear e desbloquear a conferência) usando o teclado de seus telefones.

Sintaxe

Remove-CsDialInConferencingDtmfConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Microsoft Lync Server 2010 permite que os usuários participem de conferências discando no telefone. Os usuários de discagem não podem exibir vídeos ou trocar mensagens instantâneas com outros participantes da conferência, mas podem participar totalmente da parte em áudio da reunião.

Além de poder participar de uma conferência, os usuários também podem gerenciar partes selecionadas dessa conferência usando o teclado de seus telefones. (as definições específicas da conferência que os usuários podem gerenciar dependerão de eles serem ou não um apresentador). Por exemplo, por padrão, os usuários podem pressionar a tecla 6 do teclado para ativar ou desativar o mudo. Os participantes podem reproduzir de maneira privativa os nomes de todos os outros participantes da reunião, enquanto os apresentadores podem realizar ações como ativar e desativar o mudo de todos os participantes da reunião, e ativar e desativar o comunicado que é reproduzido sempre que alguém entrar ou sair de uma conferência.

A capacidade de realizar seleções como essas usando o teclado de um telefone é conhecida como sinalização DTMF (multifrequência de tom dual): se você já discou um número de telefone e foi instruído a fazer algo do tipo "Pressione 1 para inglês ou pressione 2 para espanhol", então já usou a sinalização DTMF.

Quando você instala o Lync Server 2010, uma coleção global de definições DTMF é criada para você. Além dessas definições globais, é possível usar o cmdlet New-CSDialInConferencingDtmfConfiguration para criar definições personalizadas para cada site. As configurações que você criar no escopo do site podem ser removidas mais tarde com o cmdlet Remove-CSDialInConferencingDtmfConfiguration. Quando as definições de DTMF aplicadas ao escopo do site são removidas, os usuários no site afetado entram automaticamente sob a jurisdição das definições de configuração globais de DTMF.

Você também pode executar o Remove-CSDialInConferencingDtmfConfiguration nas definições globais. No entanto, nesse caso, as definições globais não serão removidas; isso acontece porque você não pode remover as definições globais de DTMF. Em vez disso, serão restaurados os valores padrão das propriedades nas definições globais. Por exemplo, suponha que você tenha modificado as definições gobais para definir a tecla 4 para ativar/desativar o mudo. Se você executar Remove-CSDialInConferencingDtmfConfiguration nas definições globais, o valor da tecla para ativar/desativar o mudo será redefinido para o valor padrão de 6.

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Obrigatório

XdsIdentity

Identificador único da coleção de configurações de DTMF a ser removida. Para "remover" as definições globais, use esta sintaxe: -Identity global. (como observado anteriormente, não é possível remover a definição global; é possível apenas redefinir as propriedades aos seus valores padrão). Para remover uma coleção configurada em escopo de site, use uma sintaxe semelhante a esta: -Identity site:Redmond. Não é possível utilizar curingas para especificar uma identidade

Force

Opcional

Parâmetro de opção

Suprime a exibição de qualquer mensagem de erro não-fatal que possa ocorrer durante a execução do comando.

WhatIf

Opcional

SwitchParameter

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

Confirm

Opcional

SwitchParameter

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

Tipos de Entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.DialInConferencingSettings.DialInConferencingDtmfConfiguration. Remove-CsDialInConferencingDtmfConfiguration aceita instâncias em pipeline do objeto de configuração DTMF de conferência discada.

Tipos de Retorno

Nenhuma. Em vez disso, Remove-CSDialInConferencingDtmfConfiguration exclui instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.DialInConferencingSettings.DialInConferencingDtmfConfiguration.

Exemplo

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

Remove-CSDialInConferencingDtmfConfiguration -Identity site:Redmond

O comando anterior exclui a coleção de definições de configuração de DTMF com identidade site:Redmond.

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

Get-CSDialInConferencingDtmfConfiguration -Filter "site:*" | Remove-CSDialInConferencingDtmfConfiguration

O comando exibido no Exemplo 2 exclui todas as definições de DTMF configuradas em escopo de site. Para realizar esta tarefa, o comando usa primeiro Get-CSDialInConferencingDtmfConfiguration e o parâmetro Filter para retornar uma coleção de todas as definições de DTMF que tenham sido configuradas em escopo de site; o valor de filtro "site:*" garante que somente configurações que tenham identidade começando com o valor de cadeia de caracteres "site:" serão retornadas. Essa coleção filtrada é então canalizada para Remove-CSDialInConferencingConfiguration, que remove todos os itens da coleção.

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

Get-CSDialInConferencingDtmfConfiguration | Where-Object {$_.PrivateRollCallCommand -eq $Null} | Remove-CSDialInConferencingDtmfConfiguration

No Exemplo 3, Remove-CSDialInConferencingDtmfConfiguration é usado para excluir todas as definições de DTMF nas quais a propriedade PrivateRollCallCommand seja igual a um valor nulo (ou seja, onde o comando de lista de chamadas particulares tenha sido desabilitado). Para fazer isso, o comando primeiramente usa Get-CSDialInConferencingDtmfConfiguration para retornar uma coleção de todas as definições de DTMF em uso na organização. Esta coleção é então canalizada para o cmdlet Where-Object, que seleciona apenas as definições nas quais PrivateRollCallCommand seja igual a um valor nulo. A coleção filtrada é então canalizada para Remove-CSDialInConferencingDtmfConfiguration, que exclui todos os itens da coleção.