Compartilhar via

  • Artigo

New-CsDialInConferencingConfiguration

 

Tópico modificado em: 2012-03-23

Cria uma nova coleção de definições de configuração de conferências discadas. Essas definições determinam como o Microsoft Lync Server 2010 responde quando os usuários entram ou saem de uma conferência discada. Mais especificamente, retornam-se informações sobre a exigência feita aos participantes de registrarem ou não o seu nome ao entrar em uma conferência e como (ou se) o sistema anunciará que alguém entrou na chamada ou a abandonou.

Sintaxe

New-CsDialInConferencingConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-EnableNameRecording <$true | $false>] [-EntryExitAnnouncementsEnabledByDefault <$true | $false>] [-EntryExitAnnouncementsType <UseNames | ToneOnly>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Quando os usuários ingressam em (ou deixam) uma conferência discada, o Lync Server 2010 pode responder de formas diferentes. Por exemplo: os participantes podem ser solicitados a registrar o seu nome, para que possam entrar na conferência. Da mesma forma, os administradores podem decidir se querem que o Lync Server anuncie que os participantes discados deixaram ou ingressaram em uma conferência.

Esses "comportamentos de entrada" de conferência são gerenciados utilizando-se definições de configuração de conferência, que podem ser configuradas no escopo global ou de site. (As definições configuradas no escopo do site têm precedência sobre as definições configuradas no escopo global.) Ao se instalar pela primeira vez o Lync Server, as únicas definições de configuração de conferências discadas serão as do escopo global. Entretanto, é possível criar novas definições no escopo de site, utilizando-se o cmdlet New-CSDialInConferencingConfiguration.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet New-CsDialInConferencingConfiguration localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet foi atribuído (inclusive qualquer função RBAC personalizada que tenha sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Obrigatório

Identidade de Xds

Indica a identidade das definições de configuração de conferência discada a serem criadas. Como essas definições podem ser criadas apenas no escopo de site, utilize uma sintaxe similar a essa, com o prefixo "site:" seguidos pelo nome do site: -Identity site:Redmond.

Observe que só pode haver um conjunto de definições de configuração de conferência discada por site. O comando no exemplo falhará se já existir uma coleção de definições com a identidade site:Redmond.

EnableNameRecording

Opcional

Booleano

Determina se os usuários serão solicitados ou não a registrar os seus nomes antes de entrar na conferência. Defina como True ($True), para solicitar o registro de nome; defina como False ($False), para ignorar o registro de nome. O valor padrão é True.

EntryExitAnnouncementsEnabledByDefault

Opcional

Booleano

Se este parâmetro for definido como True, os anúncios serão emitidos a cada vez que um participante entrar ou deixar uma conferência. Se definido como False (o valor padrão), não serão emitidos anúncios de entrada ou saída.

EntryExitAnnouncementsType

Opcional

Cadeia de caracteres

Indica a ação tomada pelo sistema a qualquer momento em que um participante entrar ou deixar uma conferência. Os valores válidos são:

UseNames. O nome da pessoa será anunciado toda vez que ela entrar ou deixar uma conferência (por exemplo: "Ken Myer está deixando a conferência").

ToneOnly. Um tom será emitido a cada vez que um participante entrar ou deixar uma conferência.

O valor padrão é UseNames. Observe que os comunicados serão emitidos apenas se a propriedade EntryExitAnnouncementsEnabledByDefault for definida como True.

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.

InMemory

Opcional

Objeto DialInConferencingConfiguration

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

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. New-CsDialInConferencingConfiguration não aceita a entrada canalizada.

Tipos de Retorno

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

Exemplo

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

New-CSDialInConferencingConfiguration -Identity site:Redmond -EnableNameRecording $False

O comando apresentado no Exemplo 1 cria uma nova coleção de definições de configuração de conferência discada, que são aplicadas ao site de Redmond. Além disso, o parâmetro opcional EnableNameRecording é incluído para definir a propriedade EnableNameRecording como sendo False.

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

$x = New-CSDialInConferencingConfiguration -Identity site:Redmond -InMemory
$x.EnableNameRecording = $False
Set-CSDialInConferencingConfiguration -Instance $x

No Exemplo 2, o parâmetro InMemory é utilizado para criar uma nova coleção de definições de configuração de conferências discadas que, inicialmente, existirá somente na memória. Para fazer isso, o exemplo chama primeiramente New-CSDialInConferencingConfiguration e o parâmetro InMemory, para criar uma coleção "virtual" de definições, que é armazenada na variável $x (observe que a esta coleção receberá a identidade site:Redmond). Após a criação da coleção virtual, a linha 2 será utilizada para modificar o valor da propriedade EnableNameRecording. Finalmente, a linha 3 do exemplo chamará Set-CSDialInConferencingConfiguration para transformar as definições de configuração virtual armazenadas em $x na coleção de definições aplicadas ao site de Redmond.