Compartilhar via

  • Artigo

Set-CsDialInConferencingDtmfConfiguration

 

Tópico modificado em: 2012-03-27

Modifica 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

Set-CsDialInConferencingDtmfConfiguration [-Identity <XdsIdentity>] [-AdmitAll <String>] [-AudienceMuteCommand <String>] [-CommandCharacter <String>] [-Confirm [<SwitchParameter>]] [-EnableDisableAnnouncementsCommand <String>] [-Force <SwitchParameter>] [-HelpCommand <String>] [-LockUnlockConferenceCommand <String>] [-MuteUnmuteCommand <String>] [-PrivateRollCallCommand <String>] [-WhatIf [<SwitchParameter>]]

Set-CsDialInConferencingDtmfConfiguration [-AdmitAll <String>] [-AudienceMuteCommand <String>] [-CommandCharacter <String>] [-Confirm [<SwitchParameter>]] [-EnableDisableAnnouncementsCommand <String>] [-Force <SwitchParameter>] [-HelpCommand <String>] [-Instance <PSObject>] [-LockUnlockConferenceCommand <String>] [-MuteUnmuteCommand <String>] [-PrivateRollCallCommand <String>] [-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á tiver discado 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 Set-CsDialInConferencingDtmfConfiguration permite modificar as teclas usadas para acionar os comandos suportados em uma conferência discada do Lync Server 2010.

Ao modificar os comandos DTMF, lembre-se de duas coisas. Primeiro, é possível usar apenas as teclas numéricas de 0 a 9; qualquer outra tecla encontrada em seu teclado (como a tecla #) não será permitida. Há uma exceção a essa regra: o parâmetro CommandCharacter permite usar apenas a tecla de asterisco (*), ou a tecla de cerquilha (#). Não é possível atribuir um valor numérico ao parâmetro CommandCharacter. No entanto, todos os outros parâmetros de comando aceitarão apenas valores numéricos.

Segundo, devem ser atribuídas teclas exclusivas aos comandos; por exemplo, a tecla 4 não pode ser usada para ativar e desativar o mudo e bloquear e desbloquear a conferência. Isso significa que, ao se modificar as teclas atribuídas a um comando, talvez seja necessário trocar as teclas usadas por dois comandos diferentes. Por exemplo: se desejar atribuir a tecla 4 para EnableDisableAnnouncementsCommand (valor padrão: 9) é necessário, no mesmo comando, atribuir a tecla 9 para AudienceMuteCommand.

Para desabilitar um comando, defina seu valor como Null ($Null).

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

Cadeia de caracteres

Indica o identificador exclusivo da coleção de definições DTMF que se deseja modificar. 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 esse parâmetro não for especificado, Set-CsDialInConferencingDtmfConfiguration modificará as definições globais de DTMF.

Instance

Opcional

Objeto DialInConferencingDtmfConfiguration

Permite passar uma referência a um objeto para o cmdlet, em vez de definir valores de parâmetros individuais.

AdmitAll

Opcional

Cadeia de caracteres

Indica a tecla a ser pressionada para permitir que todos os usuários no lobby ingressem imediatamente na conferência. O valor padrão é 8.

AudienceMuteCommand

Opcional

Cadeia de caracteres

Indica a tecla que um apresentador pode pressionar para ativar o mudo de todas as pessoas na conferência (ou seja, desativar os microfones de todos os participantes, com exceção do apresentador). A tecla padrão é 4.

CommandCharacter

Opcional

Cadeia de caracteres

Indica a tecla a ser pressionada no começo de um comando. A tecla padrão é o asterisco (*); o único valor permitido além desse é a tecla de cerquilha (#).

EnableDisableAnnouncementsCommand

Opcional

Cadeia de caracteres

Indica a tecla a ser pressionada para habilitar ou desabilitar comunicados sempre que alguém ingressar ou sair da conferência. A tecla padrão é 9.

HelpCommand

Opcional

Cadeia de caracteres

Indica a tecla a ser pressionada para reproduzir, em caráter particular, uma descrição de todos os comandos DTMF. A tecla padrão é 1.

LockUnlockConferenceCommand

Opcional

Cadeia de caracteres

Indica a tecla a ser pressionada para bloquear ou desbloquear uma conferência. Se uma conferência for bloqueada, nenhum participante poderá ingressar nessa conferência, pelo menos enquanto ela não for desbloqueada. A tecla padrão é 7.

MuteUnmuteCommand

Opcional

Cadeia de caracteres

Indica a tecla a ser pressionada para ativar ou desativar o mudo. Use a mesma tecla para alternar a ativação e a desativação do mudo. A tecla padrão é 6.

PrivateRollCallCommand

Opcional

Cadeia de caracteres

Indica a tecla a ser pressionada para reproduzir, em caráter particular, o nome de cada participante da conferência. A tecla padrão é 3.

Force

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

Parâmetro de opção

Descreve o que aconteceria se você executasse o comando sem executá-lo 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.DialInConferencingSettings.DialInConferencingDtmfConfiguration. Set-CsDialInConferencingDtmfConfiguration aceita entrada canalizada do objeto de configuração DTMF de conferências discadas.

Tipos de Retorno

Set-CsDialInConferencingDtmfConfiguration não retorna um valor ou objeto. Em vez disso, o cmdlet configura instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.DialInConferencingSettings.DialInConferencingDtmfConfiguration.

Exemplo

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

Set-CsDialInConferencingDtmfConfiguration -Identity global -EnableDisableAnnouncementsCommand 4 -AudienceMuteCommand 9

O comando exibido no Exemplo 1 inverte as teclas atribuídas ao comando para habilitar e desabilitar comunicados (valor padrão: 9) e o comando para ativar e desativar o mudo de todos os participantes (valor padrão: 4) das definições de DTMF globais. Para realizar isso, utilizam-se dois parâmetros diferentes: EnableDisableAnnoucementsCommand, que recebe o valor de parâmetro 4 e AudienceMuteCommand, que recebe o valor 9. Como nenhuma Identidade foi especificada, essas alterações afetarão as definições globais de DTMF.

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

Set-CsDialInConferencingDtmfConfiguration -Identity site:Redmond -EnableDisableAnnouncementsCommand 4 -AudienceMuteCommand 9

O comando exibido no Exemplo 2 é uma variação do comando exibido no primeiro exemplo. No entanto,nesse caso, as alterações afetam as definições DTMF que possuírem a Identidade site:Redmond.

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

Set-CsDialInConferencingDtmfConfiguration -Identity "site:Redmond" -PrivateRollCallCommand $Null

O comando exibido no Exemplo 3 desabilita o comando de lista de chamada (a capacidade de reproduzir uma lista de todos os participantes da conferência) do site de Redmond. Para desabilitar esse comando, inclui-se o parâmetro PrivateRollCallCommand, com o valor de parâmetro definido como $Null. Isso significa que nenhuma tecla será associada ao comando, tornando esse comando indisponível para os usuários.

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

Get-CsDialInConferencingDtmfConfiguration -Filter "site:*" | Set-CsDialInConferencingDtmfConfiguration -PrivateRollCallCommand $Null

O exemplo 4 é uma variação do Exemplo 3: neste exemplo, o comando de lista de chamada é desabilitado para todas as definições de DTMF configuradas no escopo de site. Para fazer isso, o comando usa primeiramente Get-CsDialInConferencingDtmfConfiguration e o parâmetro Filter, para retornar uma coleção de todas as definições configuradas no escopo de site. O valor de filtro "site:*" limita os dados retornados às definições cuja identidade começar pelos caracteres "site:". Essa coleção filtrada será então canalizada para Set-CsDialInConferencingDtmfConfiguration, que definirá o valor da propriedade PrivateRollCallCommand como sendo nulo ($Null).