Compartilhar via

  • Artigo

Remove-CsImFilterConfiguration

 

Tópico modificado em: 2012-03-27

Remove a configuração do filtro do IM (sistema de mensagens instantâneas) especificado (as configurações do filtro de IM são usadas para impedir que os usuários enviem mensagens instantâneas que contenham hiperlinks).

Sintaxe

Remove-CsImFilterConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Ao enviar mensagens instantâneas, os usuários podem inserir um URI (identificador de recurso uniforme) dentro do texto da mensagem para sugerir a outros participantes da conversa um determinado site ou compartilhamento da Web. O Microsoft Lync Server 2010 pode ser configurado para que os hiperlinks com determinados prefixos sejam bloqueados ou não permaneçam ativos (em outras palavras, os participantes não podem simplesmente clicar no link e serem levados ao site para o qual o URI leva; eles devem copiar e colá-lo manualmente em um navegador).

O cmdlet Remove-CsImFilterConfiguration remove a configuração de filtro do IM de uma identidade especificada (como um site específico). A execução do cmdlet na identidade Global simplesmente redefinirá o padrão da configuração global.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

XdsIdentity

A identidade única da configuração a ser removida. Ela será Global ou Site:<nome do site> (em que <nome do site> representa o nome do site a que as configurações se aplicam).

Tipo de Dados Completos: Microsoft.Rtc.Management.Xds.XdsIdentity

Force

Opcional

SwitchParameter

Suprime todos os avisos de confirmação que seriam exibidos antes que as alterações sejam feitas.

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.ImFilter.ImFilterConfiguration. Aceita entrada em pipeline de objetos de configuração de filtro de IM.

Tipos de Retorno

Remove um objeto do tipo Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.ImFilterConfiguration.

Exemplo

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

Remove-CsImFilterConfiguration -Identity site:Redmond

No Exemplo 1, Remove-CsImFilterConfiguration é usado para remover a configuração de filtro de IM com a propriedade Identity site:Redmond. Quando uma configuração de filtro de IM for removida de um site, ele começará a usar as configurações globais automaticamente em seu lugar.

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

Get-CsImFilterConfiguration -Filter site:* | Remove-CsImFilterConfiguration

No Exemplo 2, todas as configurações de filtro de IM em escopo de site são removidas. Para realizar essa tarefa, o comando usa inicialmente Get-CsImFilterConfiguration e o parâmetro Filter para retornar todas as configurações no escopo do site; a cadeia de caracteres curinga site:* pede para que Get-CsImFilterConfiguration retorne apenas essas configurações que tenham um parâmetro Identity que comece com o valor de cadeia de caracteres site:. Em seguida, a coleção filtrada de configurações é redirecionada para Remove-CsImFilterConfiguration, que exclui cada configuração da coleção.