Compartilhar via

  • Artigo

New-CsDialInConferencingDtmfConfiguration

 

Tópico modificado em: 2012-03-23

Cria uma uma nova coleção de configurações de sinalização DTMF (multifrequência de tom dual) usada para conferência discada. Com DTMF, o usuário que disca para uma conferência pode controlar as configurações da conferência (como ativar ou desativar o próprio microfone, ou bloquear e desbloquear a conferência) usando o teclado do telefone.

Sintaxe

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

Descrição Detalhada

Microsoft Lync Server 2010 permite que os usuários ingressem em conferências discando pelo telefone. Os usuários de discagem não podem assistir a vídeo nem trocar mensagens instantâneas com outros participantes da conferência, mas podem participar totalmente na parte de áudio da reunião.

Além de poderem ingressar em uma conferência, os usuários também poderão gerenciar partes selecionadas dessa conferência usando o teclado do telefone. (as configurações específicas de conferência que os usuários podem ou não gerenciar dependem do usuário ser 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 som de seus microfones. Os participantes podem ouvir com privacidade os nomes de todos os outros participantes da reunião, e os apresentadores podem ativar ou desativar o som do microfone de todos os participantes da reunião e ativar ou desativar o anúncio reproduzido sempre que alguém ingressa na conferência ou a abandona.

A capacidade de fazer seleções desse tipo usando o teclado do telefone é conhecida como sinalização DTMF (multifrequência de tom dual): se você já discou um número de telefone e recebeu instruções como "aperte 1 para português, aperte 2 para espanhol", então você usou a sinalização DTMF.

Ao instalar o Lync Server 2010, uma coleção global de configurações de DTMF será criada para você. Além dessas configurações globais, o cmdlet New-CSDialInConferencingDtmfConfiguration pode ser usado para a criação de configurações personalizadas site a site. É possível, por exemplo, criar uma nova coleção de configurações para o site Redmond (e apenas para ele) que use a tecla 4 em vez da 6 como tecla para ativar e desativar o microfone. Observe que configurações definidas no escopo do site têm precedência sobre configurações definidas no escopo global. Como resultado, os usuários no site Redmond usarão a tecla 4 para ativar e desativar o microfone, mesmo que as configurações globais usem a tecla 6 para essa função.

Só é possível ter uma coleção de definições de DTMF (e uma coleção global) por site. Por exemplo, suponha que você já tenha uma coleção com Identidade site:Redmond e tente executar este comando:

New- CSDialInConferencingDtmfConfiguration –Identity site:Redmond

O comando vai falhar, pois a coleção site:Redmond já existe. Se quiser modificar as configurações para o site Redmond, use o cmdlet Set-CSDialInConferencingDtmfConfiguration ou remova a coleção existente e crie uma nova coleção que use a Identidade site:Redmond

Ao configurar valores para os comandos de DTMF, tenha duas coisas em mente. Primeiro, só podem ser usadas as teclas numéricas de 0 a 9 e o asterisco (*); outras teclas que possam existir no seu teclado (como #) não são permitidas (com uma exceção: a tecla CommandCharacter só aceita a tecla * ou a tecla #). Segundo, cada comando deve ser atribuído a teclas exclusivas; por exemplo, a tecla 4 não pode ser usada simultaneamente para ativar e desativar o microfone, nem para bloquear e desbloquear uma conferência. Ou seja, ao modificar as teclas atribuídas a um comando, pode ser necessário trocar as teclas usadas por dois comandos diferentes. Por exemplo, para atribuir EnableDisableAnnouncementsCommand à tecla 4 (valor padrão: 9), atribua no mesmo comando AudienceMuteCommand à tecla 9.

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

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet New-CsDialInConferencingDtmfConfiguration localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsDialInConferencingDtmfConfiguration"}

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

Xds Identity

Identificador exclusivo a ser atribuído à nova coleção das definições de configuração de DTMF. Porque você pode somente criar novas coleções no escopo do site, a Identity vai sempre ser o prefixo "site:" seguida do nome do site; por exemplo "site:Redmond".

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 deve pressionar para ativar ou desativar todos os demais microfones da conferência (ou seja, ativa ou desativa os microfones de todos os participantes, exceto 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 alternativo permitido é #.

EnableDisableAnnouncementsCommand

Opcional

Cadeia de caracteres

Indica a tecla a ser pressionada para ativar ou desativar anúncios sempre que alguém ingressar na conferência ou sair dela. A tecla padrão é 9.

HelpCommand

Opcional

Cadeia de caracteres

Indica a tecla a ser pressionada para reproduzir com privacidade uma descrição de todos os comandos de 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 novo poderá ingressar na conferência até que a conferência seja desbloqueada. A tecla padrão é 7.

MuteUnmuteCommand

Opcional

Cadeia de caracteres

Indica a tecla a ser pressionada para ativar ou desativar seu próprio microfone; a mesma tecla é usada para alternar entre a ativação e a desativação. A tecla padrão é 6.

PrivateRollCallCommand

Opcional

Cadeia de caracteres

Indica a tecla a ser pressionada para reproduzir com privacidade o nome de cada participante da conferência. A tecla padrão é 3.

Force

Opcional

Parâmetros de Opção

Suprime a exibição de mensagens de erro não fatais que possam ocorrer na execução do comando.

InMemory

Opcional

SwitchParameter

Cria uma referência de objeto, sem na verdade executar o objeto como uma alteração permanente. Se a saída deste cmdlet for atribuída, chamando-o com este parâmetro a uma variável, você poderá realizar alterações às propriedades da referência do objeto e executar estas alterações, chamando-se o cmdlet coincidente Set- deste cmdlet.

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

Nenhuma. New-CsDialInConferencingDtmfConfiguration não aceita entrada em pipeline.

Tipos de Retorno

Cria novas instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.DialInConferencingSettings.DialInConferencingDtmfConfiguration.

Exemplo

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

New-CSDialInConferencingDtmfConfiguration -Identity site:Redmond -MuteUnmuteCommand 4 -AudienceMuteCommand 6

O comando mostrado no Exemplo 1 criam um novo conjunto de configurações de DTMF para o site Redmond. Neste exemplo, a propriedade MuteUnmuteCommand é definida como 4 e a propriedade AudienceMuteCommand é definida como 6.

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

New-CSDialInConferencingDtmfConfiguration -Identity site:Redmond -AdmitAll $Null

O comando anterior cria um novo conjunto de configurações de DTMF para o site Redmond. Neste exemplo, a propriedade AdmitAll é desativada; isso é feito com o parâmetro AdmitAll e definindo o valor do parâmetro como nulo.

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

$x = New-CSDialInConferencingDtmfConfiguration -Identity site:Redmond -InMemory
$x.AdmitAll = $Null
$x.MuteUnmuteCommand = 4 
$x.AudienceMuteCommand = 6
Set-CSDialInConferencingDtmfConfiguration -Instance $x

O Exemplo 3 mostra como usar o parâmetro InMemory para criar uma instância somente em memória de uma coleção de configurações de DTMF, modificar estas configurações e então usar Set-CSDialInConferencingDtmfConfiguration para criar uma coleção de fato com Identidade site:Redmond. Para isso, o primeiro comando do exemplo cria uma nova instância somente em memória de uma coleção de configurações de DTMF, armazenando esta instância em uma variável chamada $x. Estas configurações vão existir somente em memória; se você fechar o Windows PowerShell ou excluir a variável $x, as configurações vão desaparecer e nunca vão ser aplicadas ao site Redmond.

Os próximos três comandos modificam as propriedades dessa coleção "virtual" de configurações de DTMF: os comandos 2, 3 e 4 atribuem novos valores a AdmitAll, MuteUnmuteCommand e AudienceMuteCommand, respectivamente. O comando final então usa Set-CSDialInConferencingDtmfConfiguration e o parâmetro Instance para transformar as configurações virtuais armazenadas em $x em uma coleção real de configurações, definidas no site Redmond.