Compartilhar via

  • Artigo

Set-CsDialInConferencingConfiguration

 

Tópico modificado em: 2012-03-25

Modifica as definições que determinam como o Microsoft Lync Server 2010 responde quando os usuários entram ou saem de uma conferência discada.

Sintaxe

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

Set-CsDialInConferencingConfiguration [-Confirm [<SwitchParameter>]] [-EnableNameRecording <$true | $false>] [-EntryExitAnnouncementsEnabledByDefault <$true | $false>] [-EntryExitAnnouncementsType <UseNames | ToneOnly>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Quando os usuários entram (ou saem) de uma conferência discada, o Lync Server 2010 pode responder de diversas formas. Por exemplo, pode ser pedido aos participantes que registrem os seus nomes antes de entrarem na conferência. Do mesmo modo, os administradores podem decidir se desejam que o Lync Server anuncie que participantes discados saíram ou entraram 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. Ao se instalar pela primeira vez o Lync Server, as únicas definições de configuração de conferência discada serão as do escopo global. Entretanto, é possível criar novas definições no escopo de site, utilizando-se o cmdlet New-CsDialInConferencingConfiguration. Além disso, é possível modificar quaisquer dessas definições de configuração (nos escopos global ou de site), utilizando-se o cmdlet Set-CsDialInConferencingConfiguration.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

Indica a identidade das definições de configuração de conferência discada a ser modificadas. Para fazer referência às definições globais, use esta sintaxe: -Identity global. Para se referir às definições de site, utilize uma sintaxe similar a esta: -Identity site:Redmond. Observe que não é possível utilizar caracteres curinga ao se especificar uma identidade.

Instance

Opcional

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

EnableNameRecording

Booleano

Determina se os usuários serão solicitados ou não a registrar os seus nomes antes de entrar na conferência. Definido como True para habilitar o registro de nomes; definido como False para ignorar o registro de nomes. O valor padrão é True.

EntryExitAnnouncementsEnabledByDefault

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

Cadeia de caracteres

Indica a ação tomada pelo sistema a qualquer momento em que um participante entrar ou deixar uma conferência. Os anúncios serão feitos apenas se EntryExitAnnoucementsEnabledByDefault estiver definido como True. 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.

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

Parâmetro de opção

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

Confirm

Parâmetro de opção

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

Tipos de Entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.DialInConferencingSettings.DialInConferencingConfiguration. Set-CSDialInConferencingConfiguration aceita instâncias canalizadas do objeto de configuração de conferência discada.

Tipos de Retorno

Set-CSDialInConferencingConfiguration não retorna qualquer objeto ou valor. Em vez disso, o cmdlet modifica as instâncias existentes do objeto Microsoft.Rtc.Management.WritableConfig.Settings.DialInConferencingSettings.DialInConferencingConfiguration.

Exemplo

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

Set-CsDialInConferencingConfiguration -Identity site:Redmond -EntryExitAnnouncementsType "ToneOnly"

O comando mostrado no Exemplo 1 modifica a propriedade EntryExitAnnoucements das definições de configuração de discagem para o site de Redmond. Neste caso, a propriedade EntryExitAnnouncementsType é definida como ToneOnly.

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

Get-CsDialInConferencingConfiguration | Set-CsDialInConferencingConfiguration -EnableNameRecording $True

O Exemplo 2 modifica todos os parâmetros de configuração de conferência discada em uso na organização. Para fazer isso, o comando utiliza inicialmente Get-CsDialInConferencingConfiguration, retornando uma coleção de todas as definições de conferência discada. Esta coleção será canalizada para Set-CsDialInConferencingConfiguration, que definirá a propriedade EnableNameRecording de cada item na coleção como sendo True ($True).

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

Get-CsDialInConferencingConfiguration -Filter "site:*" | Set-CsDialInConferencingConfiguration -EnableNameRecording $True -EntryExitAnnouncementsType "UseNames"

O comando anterior modifica todos os parâmetros de conferência discada que tiverem sido configurados no escopo do site. Para realizar essa tarefa, o comando utiliza inicialmente Get-CsDialInConferencingConfiguration e o parâmetro Filter, para retornar uma coleção de todas as definições configuradas no escopo do site; o valor de filtro "site:*" restringe os dados retornados a definições cuja identidade for iniciada pelo valor da cadeia de caracteres "site:". Esta coleção de filtragem será canalizada para Set-CsDialInConferencingConfiguration, que modificará as propriedades EnableNameRecording e EntryExitAnnouncementsType de cada item na coleção. Quando a execução do comando terminar, todas as definições de conferência discada configuradas no escopo do site terão a propriedade EnableNameRecording definida como True e a propriedade EntryExitAnnoucements definida como "UseNames".