Compartilhar via

  • Artigo

Set-CsImFilterConfiguration

 

Tópico modificado em: 2012-03-26

Modifica uma configuração existente de filtro de mensagens instantâneas (IM). As definições do filtro de IM são usadas para evitar que os usuários enviem mensagens instantâneas que contenham hyperlinks clicáveis.

Sintaxe

Set-CsImFilterConfiguration [-Identity <XdsIdentity>] [-Action <Allow | Block | Warn>] [-AllowMessage <String>] [-BlockFileExtension <$true | $false>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-IgnoreLocal <$true | $false>] [-Prefixes <PSListModifier>] [-WarnMessage <String>] [-WhatIf [<SwitchParameter>]]

Set-CsImFilterConfiguration [-Action <Allow | Block | Warn>] [-AllowMessage <String>] [-BlockFileExtension <$true | $false>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-IgnoreLocal <$true | $false>] [-Instance <PSObject>] [-Prefixes <PSListModifier>] [-WarnMessage <String>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Ao enviar mensagens instantâneas, os usuários podem incorporar um URI dentro do texto dessa mensagem para referir outros participantes na conversa para um determinado site da Web ou compartilhamento. O Microsoft Lync Server 2010 pode ser configurado de forma que os hyperlinks com determinados prefixos sejam bloqueados ou não estejam ativos. (Em outras palavras, os participantes não podem simplesmente clicar no link e serem levados ao site indicado pelo URI. Eles deverão copiar e colá-lo manualmente em um navegador.)

O cmdlet Set-CsImFilterConfiguration permite modificar uma lista de prefixos de URI que serão filtrados, bem como habilitar e desabilitar completamente a filtragem, seja globalmente ou em um site específico. Com esse cmdlet, é possível também atualizar diversas mensagens que fornecem avisos aos usuários.

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

Cadeia de caracteres

O identificador exclusivo das definições de configuração do filtro de mensagens instantâneas que se deseja modificar. Esse valor será global ou do site:<nome do site>, em que <nome do site> é o site ao qual se aplica a configuração, como site:Redmond.

Instance

Opcional

ImFilterConfiguration

Permite passar uma referência a um objeto para o cmdlet, em vez de definir valores de parâmetros individuais. Esse cmdlet aceita um objeto do tipo Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.ImFilterConfiguration, que pode ser recuperado chamando-se o cmdlet Get-CsImFilterConfiguration.

Action

Opcional

UrlFilterAction

O valor desse parâmetro determina a ação que será tomada quando um hyperlink for incluído em uma mensagem instantânea:

Allow - os hyperlinks possuem um caractere sublinhado como prefixo, de forma que os links não estejam mais ativos. Além disso, se uma mensagem for especificada na propriedade AllowMessage, será inserida uma mensagem de notificação no início de cada mensagem instantânea contendo hyperlinks.

Block - a entrega de mensagens que contêm hyperlinks ativos é bloqueada e o Lync Server 2010 envia uma mensagem de erro ao remetente.

Warn - as mensagens que contêm hyperlinks ativos são entregues aos participantes aos quais se destinam, juntamente com uma mensagem de aviso que é inserida no começo dessas mensagens. A mensagem de aviso pode ser especificada usando-se a propriedade WarnMessage. Se Warn for especificado e nenhum WarnMessage for inserido, a filtragem de mensagens instantâneas será desabilitada, embora as definições da propriedade BlockFileExtension continuarão a ser cumpridas.

AllowMessage

Opcional

Cadeia de caracteres

Se for um valor especificado para esse parâmetro, a cadeia de caracteres será inserida no começo de cada mensagem que contém hyperlinks, quando o valor da propriedade Action for definido como Allow. É possível usar essa mensagem para notificar os usuários sobre fatos como os possíveis riscos de clicar em links desconhecidos ou sobre políticas e requisitos importantes de sua organização.

BlockFileExtension

Opcional

Booleano

Se esse parâmetro for definido como True, será bloqueado o hyperlink que contiver um caminho de arquivo com uma extensão especificada pela propriedade Extensions na classe Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.FileTransferFilterConfiguration (recuperada chamando-se o cmdlet Get-CsFileTransferFilterConfiguration) e será retornada uma mensagem de erro ao remetente. Se esse parâmetro for definido como False, não será feita qualquer verificação especial dos caminhos e das extensões de arquivos.

Padrão: Verdadeiro

Enabled

Opcional

Booleano

Habilita ou desabilita esse recurso. Se esse parâmetro for definido como True, as mensagens instantâneas serão verificadas quanto à presença de hyperlinks e as regras nessa configuração serão aplicadas. Se esse parâmetro for definido como False, as mensagens não serão verificadas quanto à presença de hyperlinks.

Padrão: Verdadeiro

IgnoreLocal

Opcional

Booleano

O valor desse parâmetro controla se a filtragem será realizada nos URIs da Intranet local passados em mensagens instantâneas. Se esse parâmetro for definido como True, qualquer URI que for definido na zona da Intranet do computador local será ignorado. (O computador local é o Servidor Front-End que executa o aplicativo do Filtro de IM). Se esse parâmetro for definido como False, a filtragem especificada será aplicada a todos os hyperlinks.

Padrão: Verdadeiro

Prefixes

Opcional

PSListModifier

A lista de prefixos de URI que serão filtrados. Todos os hyperlinks incluídos em uma mensagem instantânea com um prefixo que corresponda a um dos prefixos nessa lista serão filtrados de acordo com as definições especificadas.

Padrão: callto:, file:, ftp., ftp:, gopher:, href, http:, https:, ldap:, mailto:, news:, nntp:, sip:, sips:, tel:, telnet:, www*.

WarnMessage

Opcional

Cadeia de caracteres

Esse parâmetro contém a mensagem de aviso que é inserida no início de cada mensagem instantânea que contém hyperlinks quando o valor da propriedade Action for definido como Warn. Normalmente, essa mensagem seria usada para declarar os possíveis riscos de se clicar em links desconhecidos ou para fazer referência a políticas e requisitos importantes de sua organização.

Force

Opcional

SwitchParameter

Suprime qualquer aviso de confirmação que, de outra maneira, seria exibido antes de se realizar as alterações.

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 entradas canalizadas de objetos de configuração do filtro de IM.

Tipos de Retorno

Set-CsImFilterConfiguration não retorna um valor ou objeto. Em vez disso, o cmdlet configura instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.ImFilterConfiguration.

Exemplo

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

Set-CsImFilterConfiguration -Identity site:Redmond -Enabled $False

O comando exibido nesse exemplo desabilita a filtragem de URI da configuração do filtro de IM cuja Identidade for site:Redmond. Para realizar essa tarefa, o parâmetro Enabled é especificado na chamada do cmdlet Set-CsImFilterConfiguration com o valor $False.

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

$x = Get-CsImFilterConfiguration -Identity site:Redmond
$x.Prefixes.Add("urn:")
Set-CsImFilterConfiguration -Instance $x

O conjunto de comandos anterior adiciona um novo prefixo de URI (urn:) à lista de prefixos proibidos pela configuração do filtro de IM de site:Redmond. Para adicionar um novo prefixo, o cmdlet Get-CsImFilterConfiguration é usado para recuperar a configuração de site:Redmond. O objeto retornado que representar essa configuração será armazenado em uma variável denominada $x. Depois que as definições tiverem sido recuperadas, o método Add() é chamado na linha 2 para adicionar urn: ao conjunto de prefixos armazenados na propriedade Prefixes. Isso altera o valor da referência de objeto $x. Para se alterar a configuração real, a linha 3 chama o cmdlet Set-CsImFilterConfiguration, passando $x como o único valor de parâmetro.

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

Set-CsImFilterConfiguration -Identity site:Redmond -Prefixes @{add="urn:"}

O Exemplo 3 realiza exatamente a mesma ação que o Exemplo 2, mas em uma linha. Nesse comando, o parâmetro Prefixes do cmdlet Set-CsImFilterConfiguration é usado para adicionar urn: à lista de prefixos. O modificador da lista de adição é usado para adicionar esse valor à lista de prefixos.

-------------------------- Exemplo 4 --------------------------

Set-CsImFilterConfiguration -Identity site:Redmond -Prefixes @{remove="urn:"}

Nesse exemplo, o prefixo urn: é removido da lista de prefixos bloqueados pela configuração do filtro de IM de site:Redmond. Esse exemplo é idêntico ao Exemplo 3, mas em vez de chamar o modificador da lista de adição para adicionar um prefixo à lista, o modificador de remoção é chamado para remover um prefixo.