Compartilhar via

  • Artigo

Get-CsDialInConferencingDtmfConfiguration

 

Tópico modificado em: 2012-03-23

Retorna as definições de sinalização DTMF (multifrequência de tom dual) utilizadas em conferências discadas. 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

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

Get-CsDialInConferencingDtmfConfiguration [-Filter <String>] [-LocalStore <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 usando o teclado de um telefone é conhecida como sinalização DTMF (multifrequência de tom dual): Se você já tiver discado para um número de telefone e tiver recebido instruções para fazer algo do tipo "Pressione 1 para inglês ou pressione 2 para espanhol", então já usou a sinalização DTMF. O cmdlet Get-CsDialInConferencingDtmfConfiguration permite recuperar uma lista de todos os comandos DTMF disponíveis, bem como as teclas utilizadas para efetuar esses comandos.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

Cadeia de caracteres

Indica o identificador exclusivo da coleção de definições DTMF que se deseja retornar. Para fazer referência às definições globais, utilize esta sintaxe: -Identity global. Para fazer referência a uma coleção configurada no escopo do site, use uma sintaxe semelhante a esta: -Identity site:Redmond. Observe que não é possível utilizar caracteres curinga ao se especificar uma identidade. Se precisar utilizar caracteres curinga, use, em vez disso, o parâmetro Filter.

Se esse parâmetro não for especificado, Get-CsDialInConferencingDtmfConfiguration retornará uma coleção de todas as definições DTMF em uso na organização.

Filter

Opcional

Cadeia de caracteres

Permite utilizar caracteres curinga para retornar uma coleção (ou coleções) de definições de configuração DTMF. Para retornar uma coleção de todas as definições configuradas no escopo de site, utilize esta sintaxe: -Filter site:*. Para retornar uma coleção de todas as definições que contêm o valor da cadeia de caracteres "EMEA" em alguma posição de sua identidade (a única propriedade que se pode filtrar), utilize esta sintaxe: -Filter *EMEA*.

LocalStore

Opcional

Parâmetro de opção

Recupera os dados de configuração de DTMF na réplica local do Repositório de Gerenciamento Central, em vez do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma. Get-CsDialInConferencingDtmfConfiguration não aceita a entrada canalizada.

Tipos de Retorno

Get-CsDialInConferencingDtmfConfiguration retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.DialInConferencingSettings.DialInConferencingDtmfConfiguration.

Exemplo

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

Get-CsDialInConferencingDtmfConfiguration -Identity site:Redmond

O comando apresentado no Exemplo 1 retorna as definições DTMF do site de Redmond.

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

Get-CsDialInConferencingDtmfConfiguration | Select-Object Identity, HelpCommand

O Exemplo 2 retorna uma coleção de todas as definições DTMF e, em seguida, para cada item na coleção, exibe o valor da tecla a ser pressionada para ouvir privativamente uma descrição dos comandos DTMF. Para fazer isso, Get-CsDialInConferencingDtmfConfiguration é chamado, para retornar uma coleção de todos os valores de propriedade de todas as definições DTMF em uso na organização. Esta coleção será então canalizada para o cmdlet Select-Object, que selecionará duas propriedades (Identity e HelpCommand) a serem exibidas na tela.

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

Get-CsDialInConferencingDtmfConfiguration -Filter "site:*"

O comando apresentado no Exemplo 3 retorna todas as definições DTMF que tiverem sido configuradas no escopo de site. Isto é feito incluindo-se o parâmetro Filter e o valor de filtro "site:*". O valor de filtro limita os dados retornados às definições que tiverem uma identidade iniciada pelos caracteres "site:" Por definição, estas são definições configuradas no escopo de site.

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

Get-CsDialInConferencingDtmfConfiguration | Where-Object {$_.AdmitAll -ne 8}

O comando anterior retorna todas as definições de configuração DTMF cuja propriedade AdmitAll não for igual a 8 (o valor padrão). Para realizar essa tarefa, Get-CsDialInConferencingDtmfConfiguration é chamado primeiramente sem quaisquer parâmetros, para retornar uma coleção de todas as definições DTMF em uso. Essa coleção será então canalizada para o cmdlet Where-Object, que selecionará apenas as definições cuja propriedade AdmitAll não for igual a 8.