Partilhar via

  • Artigo

Get-CsImFilterConfiguration

 

Tópico modificado em: 2012-03-23

Retorna os filtros de links de mensagens instantâneas (IM) configurados na organização. Esses filtros são usados para evitar que os usuários enviem mensagens instantâneas que contêm hyperlinks com prefixos específicos (http ou telnet, por exemplo). Dependendo das definições empregadas, isso significa que qualquer URI com um prefácio de um desses esquemas será convertido em um hyperlink não-clicável ou removido.

Sintaxe

Get-CsImFilterConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsImFilterConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrição Detalhada

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

O cmdlet Get-CsImFilterConfiguration recupera todas as definições dos URIs de filtragem de mensagens instantâneas. Chamado isoladamente (sem parâmetros), Get-CsImFilterConfiguration retornará todas as definições de filtro de IM de URI, globalmente e para todos os sites. Também é possível especificar uma Identidade, para que se exibam as definições relativas a um site específico (ou as definições globais).

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Get-CsImFilterConfiguration localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet tiver sido atribuído (inclusive qualquer função RBAC personalizada que tiver sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsImFilterConfiguration"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

XdsIdentity

O identificador exclusivo das definições que se deseja recuperar. Esse valor será global ou do site:<nome do site>, onde <nome do site> é o nome do site ao qual essas definições se aplicam, como site:Redmond.

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

Filter

Opcional

Cadeia de caracteres

Realiza uma pesquisa de caractere curinga das configurações que correspondam a um determinado padrão de Identidade. Por exemplo, retorna todas as definições com identidades que começam com site* (todas as definições específicas ao site).

LocalStore

Opcional

SwitchParameter

Recupera a configuração de filtro de IM na réplica local do Repositório de Gerenciamento Central, em vez do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma.

Tipos de Retorno

Get-CsImFilterConfiguration retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.ImFilterConfiguration.

Exemplo

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

Get-CsImFilterConfiguration

O comando exibido acima retorna uma coleção de todos os filtros de hyperlinks de IM configurados para uso na organização. Esse será o comportamento padrão sempre que se chamar Get-CsImFilterConfiguration sem qualquer parâmetro adicional.

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

Get-CsImFilterConfiguration -Identity site:Redmond

O exemplo anterior retorna definições referentes a um filtro de mensagens instantâneas: as definições que possuírem a Identidade site:Redmond. Como as identidades devem ser exclusivas, este comando nunca retornará mais do que uma configuração.

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

Get-CsImFilterConfiguration -Filter site:*

O Exemplo 3 usa o parâmetro Filter para retornar uma coleção de todos os filtros de IM que tiverem sido configurados no nível de site. A cadeia de caracteres curinga site:* informa a Get-CsImFilterConfiguration que retorne apenas as configurações de filtro de IM cuja identidade for iniciada pelo valor da cadeia de caracteres site:.

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

(Get-CsImFilterConfiguration -Identity Global).Prefixes

No Exemplo 4, o valor da propriedade global Prefixes das configurações de filtro de IM será expandido quando for exibido na tela. Isso significa que a propriedade e os seus valores serão exibidos em um formato mais fácil e legível. Para realizar essa tarefa, utiliza-se primeiramente Get-CsImFilterConfiguration, para recuperar a configuração global de filtro de IM. (observe que a chamada de Get-CsImFilterConfiguration é mantida entre parênteses. Isso informa ao Windows PowerShell que execute primeiramente o comando entre parênteses e depois prossiga deste ponto). Depois que a configuração tiver sido recuperada, será exibido o valor da propriedade Prefixes, com um prefixo em cada linha.