Compartilhar via

  • Artigo

Remove-CsDialInConferencingConfiguration

 

Tópico modificado em: 2012-03-26

Remove uma ou mais coleções das definições de configuração da conferência discada. Essas definições determinam como o Microsoft Lync Server 2010 responde quando os usuários entram ou saem de uma conferência discada.

Sintaxe

Remove-CsDialInConferencingConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <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 seu nome para que possam entrar na conferência propriamente dita. 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 ingresso" na conferência são gerenciados usando-se definições de configuração da conferência discada; essas configurações podem ser definidas no escopo global ou no escopo do site. (As definições configuradas no escopo do site têm precedência sobre as definições configuradas no escopo global.) Quando você instala Lync Server, uma coleção global de definições de configuração de conferência discada será criada para você. Se você quiser ter definições diferentes para um site (ou conjunto de sites), você pode criar estas coleções usando o cmdlet New-CSDialInConferencingConfiguration.

O cmdlet Remove-CSDialInConferencingConfiguration exclui quaisquer definições de conferência discada que tenham sido definidas no escopo do site. Quando estas definições específicas do site são excluídas, usuários nos sites afetados vão ter os comportamentos de sua conferência discada governados pelas definições globais.

Você pode também executar Remove-CSDialInConferencingConfiguration nas definições globais de conferência discada. Se você fizer isso, as definições globais não serão removidas; isto porque as definições globais não podem ser removidas. Ao contrário, todas as propriedades dentro desta coleção de definições serão redefinidas para seus valores padrão.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Remove-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 "Remove-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 da conferência discada a serem removidas. Para fazer referência às definições globais, utilize 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.

Force

Opcional

SwitchParameter

Suprime a exibição de qualquer mensagem de erro não-fatal que possa ocorrer durante a execução do comando.

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

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.DialInConferencingSettings.DialInConferencingConfiguration. Remove-CSDialInConferencingConfiguration aceita entrada em pipeline do objeto de configuração de conferência discada.

Tipos de Retorno

Nenhuma. Em vez disso, Remove-CSDialInConferencingConfiguration exclui instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.DialInConferencingSettings.DialInConferencingConfiguration.

Exemplo

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

Remove-CSDialInConferencingConfiguration -Identity "site:Redmond"

No Exemplo 1, as definições de configuração de conferência discada para o site Redmond são excluídas.

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

Get-CSDialInConferencingConfiguration -Filter "site:*" | Remove-CSDialInConferencingConfiguration

No exemplo anterior, todas as definições de conferência discada que foram definidas no escopo do site são excluídas. Para fazer isso, o comando primeiramente usa Get-CSDialInConferencingConfiguration e o parâmetro Filter para retornar uma coleção de todas as definições de conferência discada que foram definidas no escopo do site. (O valor do filtro "site:*" garante que somente configurações que possuem uma Identidade que começa com a cadeia de caracteres "site:" sejam retornadas). Esta coleção filtrada é então canalizada para Remove-CSDialInConferencingConfiguration, que remove cada item na coleção.

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

Get-CSDialInConferencingConfiguration | Where-Object {$_.EnableNameRecording -eq $False} | Remove-CSDialInConferencingConfiguration

No Exemplo 3, todas as definições de configuração de conferência discada que não usam gravação de nome são excluídas. Para executar esta tarefa, o comando primeiramente chama Get-CSDialInConferencingConfiguration sem nenhum parâmetro, a fim de retornar uma coleção de todas as definições de configuração de conferência discada atualmente em uso na organização. Esta coleção será canalizada para o cmdlet Where-Object, que selecionará apenas as definições cuja propriedade EnableNameRecording for igual a False. Em seguida, esta coleção filtrada é canalizada para Remove-CSDialInConferencingConfiguration, que exclui cada item na coleção.