Compartilhar via

  • Artigo

Remove-CsMeetingConfiguration

 

Tópico modificado em: 2012-03-27

Remove-CsMeetingConfiguration permite excluir uma coleção existente de definições de configuração de reuniões. As definições de configuração de reuniões ajudam a especificar o tipo de reunião (também denominada "conferência") que os usuários podem criar, e a controlar como (ou até mesmo se) os usuários anônimos e de conferência discada podem participar dessas reuniões.

Sintaxe

Remove-CsMeetingConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

As reuniões online (também chamadas de conferências) são parte integrante do Microsoft Lync Server 2010. Os cmdlets CsMeetingConfiguration permitem que os administradores controlem o tipo de reuniões que os usuários podem criar e determinam como as reuniões lidam com os usuários anônimos e usuários de conferência discada. Por exemplo: é possível configurar reuniões, de forma que qualquer pessoa que disque da rede telefônica pública comutada (PSTN) seja automaticamente admitida na reunião. Como alternativa, é possível configurar reuniões para que os usuários de rede discada não sejam admitidos automaticamente na reunião, mas encaminhados para o lobby da reunião. Esses usuários de rede discada permanecerão em espera no lobby até que um apresentador os admita na reunião.

As definições de configuração de reuniões podem ser atribuídas aos escopos global, do site ou de serviço. Se você criar novas definições no escopo do site ou de serviço, essas definições poderão ser removidas futuramente, usando-se o cmdlet Remove-CsMeetingConfiguration. Remove-CsMeetingConfiguration também pode ser executado concomitantemente às definições globais de reunião. No entanto, nesse caso, as definições não serão removidas porque as definições globais não podem ser removidas. Em vez disso, todas as propriedades na coleção global serão redefinidas com os seus valores padrão.

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Obrigatório

Identidade de Xds

Identificador exclusivo das definições de configuração de reuniões a serem removidas. Para "remover" as definições globais, use esta sintaxe: -Identity global (como observado anteriormente, na verdade, não é possível remover as definições globais; o que pode ser feito é redefinir as propriedades com os seus valores padrão). Para remover as definições do escopo do site, use uma sintaxe semelhante a esta: -Identity site:Redmond. As definições do serviço podem ser removidas usando-se essa sintaxe: -Identity service:UserServer:atl-cs-001.litwareinc.com.

Observe que não é possível utilizar caracteres curinga ao se especificar uma identidade.

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.

Tenant

Opcional

GUID

Esse parâmetro não é usado com a versão local de Lync Server 2010.

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

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.MeetingConfiguration. Remove-CsMeetingConfiguration aceita instâncias canalizadas do objeto de configuração de reunião.

Tipos de Retorno

Nenhuma. Em vez disso, Remove-CsMeetingConfiguration exclui instâncias existentes do objeto Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.MeetingConfiguration.

Exemplo

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

Remove-CsMeetingConfiguration -Identity site:Redmond

No Exemplo 1, as definições de configuração de reuniões que possuírem a Identidade site:Redmond serão removidas. Quando essas definições forem removidas do site de Redmond, os usuários nesse site herdarão automaticamente as definições de configuração global de reuniões.

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

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

O comando exibido no Exemplo 2 remove todas as definições da reunião que tiverem sido configuradas no escopo do site. Para realizar isso, o comando primeiramente chama Get-CsMeetingConfiguration, juntamente com o parâmetro Filter; o valor de filtro "site:*" garante que apenas as definições que possuírem uma Identidade que começa com os caracteres "site:" serão selecionadas. Esta coleção filtrada será então canalizada para o cmdlet Remove-CsMeetingConfiguration, que excluirá cada item nessa coleção.

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

Get-CsMeetingConfiguration | Where-Object {$_.AdmitAnonymousUsersByDefault -eq $True} | Remove-CsMeetingConfiguration

O comando precedente excluirá cada coleção de definições de configuração da reunião em que a propriedade AdmitAnonymousUsersbyDefault for Verdadeira. Para realizar essa tarefa, o comando primeiramente chama Get-CsMeetingConfiguration, para retornar uma coleção de todas as definições de configuração de reuniões que estiverem em uso. Essa coleção será então canalizada para Where-Object, que selecionará apenas as definições cuja propriedade AdmitAnonymousUsersByDefault for igual a True. Esta coleção filtrada será então canalizada para Remove-CsMeetingConfiguration, que removerá cada item nessa coleção.