Compartilhar via

  • Artigo

Get-CsFileTransferFilterConfiguration

 

Tópico modificado em: 2012-03-23

Retorna as configurações de filtro de transferência de arquivos de sua organização. Essas configurações são usadas para bloquear a capacidade de um usuário transferir certos tipos de arquivos (por exemplo, arquivos com extensão .vbs ou .ps1) usando um cliente do Microsoft Lync Server 2010.

Sintaxe

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

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

Descrição Detalhada

Ao enviar mensagens instantâneas, os usuários podem anexar e enviar arquivos a outros participantes da conversa. O Lync Server 2010 pode ser configurado de forma que arquivos com certas extensões — tipicamente extensões de arquivos potencialmente nocivos — não tenham autorização para serem enviados usando o cliente do Lync Server 2010.

O cmdlet Get-CsFileTransferFilterConfiguration oferece uma maneira de recuperar uma coleção particular de configurações (essas configurações podem estar configuradas no escopo global ou do site). As configurações de filtro de transferência de arquivos incluem a lista de extensões bloqueadas para transferência, o nível de ativação da filtragem (se todos as transferências são bloqueadas ou apenas os arquivos com as extensões especificadas) e se a filtragem de transferência de arquivos está ativada.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

XdsIdentity

Identificador exclusivo da configuração de filtro de transferência de arquivos que você deseja recuperar. Para referir-se às configurações globais, use esta sintaxe: -Identity global. Para referir-se a configurações definidas no escopo do site, use uma sintaxe semelhante a esta: -Identity site:Redmond. Observe que você não pode usar caracteres curinga ao especificar uma identidade. Para usar curingas, use o parâmetro Filter.

Filter

Opcional

Cadeia de caracteres

Permite o uso de caracteres curinga ao especificar as configurações de filtro de transferência de arquivos a serem retornadas. Por exemplo, para retornar todas as configurações de filtro de transferência de arquivos no escopo do site, use esta sintaxe: -Filter "site:*". Por natureza, as configurações de filtro de transferência de arquivos que possuem uma Identidade (a única propriedade pela qual você pode filtrar) começando com o valor de cadeia de caracteres "site:" foram configuradas no escopo do site.

LocalStore

Opcional

Parâmetro de opção

Recupera a configuração de filtro de transferência de arquivo a partir da réplica local do Repositório de Gerenciamento Central, e não do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma.

Tipos de Retorno

Get-CsFileTransferFilterConfiguration retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.FileTransferFilterConfiguration.

Exemplo

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

Get-CsFileTransferFilterConfiguration

O comando mostrado no Exemplo 1 retorna uma coleção de todas as configurações de filtro de transferência de arquivos definidas para uso em sua organização. Esse é o comportamento padrão sempre que Get-CsFileTransferFilterConfiguration é chamado sem nenhum parâmetro adicional.

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

Get-CsFileTransferFilterConfiguration -Identity site:Redmond

O exemplo anterior retorna uma única configuração de filtro de transferência de arquivos: a configuração com Identidade site:Redmond. Como as identidades precisam ser exclusivas, esse comando nunca retornará mais de uma configuração.

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

Get-CsFileTransferFilterConfiguration -Filter site:*

O Exemplo 3 usa o parâmetro Filter para retornar uma coleção de todas as configurações de filtro de transferência de arquivos em nível de site. O filtro de valor "site:*" instrui o Get-CsFileTransferFilterConfiguration a retornar somente as configurações que possuam identidade começando por "site:".

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

Get-CsFileTransferFilterConfiguration | Where-Object {$_.Extensions -contains ".xls"}

O comando mostrado no Exemplo 4 retorna somente as configurações de filtro de transferência de arquivos que incluam .xls em sua lista de extensões de arquivo proibidas. Para fazer isso, Get-CsFileTransferFilterConfiguration é usado primeiro para retornar uma coleção de todas as configurações em uso em sua organização. Em seguida, essa coleção é canalizada para o cmdlet Where-Object, que aplica um filtro que restringe os dados retornados às configurações cuja propriedade Extensions inclua (-contains) o valor de cadeia de caracteres ".xls".

-------------------------- Exemplo 5 --------------------------

Get-CsFileTransferFilterConfiguration | Where-Object {$_.Enabled -eq $False}

O comando anterior retorna todas as configurações de filtro de transferência de arquivos que estejam desabilitadas no momento. Para realizar essa tarefa, Get-CsFileTransferFilterConfiguration é usado primeiro para retornar uma coleção de todas as configurações em uso em sua organização. Essa coleção é então canalizada para o cmdlet Where-Object que, por sua vez, seleciona somente as configurações com propriedade Enabled igual a (-eq) True ($True).

-------------------------- Exemplo 6 --------------------------

Get-CsFileTransferFilterConfiguration -Identity Global | Select-Object -ExpandProperty Extensions

O Exemplo 6 mostra uma lista completa de todas as extensões de arquivos proibidas pela configuração global de filtro de transferência de arquivos. O comando começa com uma chamada ao cmdlet Get-CsFileTransferFilterConfiguration, especificando a configuração Global. As informações retornadas são então canalizadas para o cmdlet Select-Object, que usa o parâmetro ExpandProperty para "expandir" o valor da propriedade Extensions. Isso resulta na exibição da lista completa de extensões de arquivos na tela, com uma extensão por linha.