Compartilhar via

  • Artigo

Set-CsFileTransferFilterConfiguration

 

Tópico modificado em: 2012-03-26

Modifica uma coleção de definições de configuração de filtros de transferência de arquivos. As definições de filtros de transferência de arquivos são usadas para bloquear a capacidade do usuário transferir certos tipo de arquivo (arquivos com extensões .vbs ou .ps1, por exemplo) utilizando clientes Microsoft Lync Server 2010.

Sintaxe

Set-CsFileTransferFilterConfiguration [-Identity <XdsIdentity>] [-Action <BlockAll | Block>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Extensions <PSListModifier>] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Set-CsFileTransferFilterConfiguration [-Action <BlockAll | Block>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Extensions <PSListModifier>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Ao enviar mensagens instantâneas, os usuários podem anexar e enviar arquivos para outros participantes da conversa. O Lync Server 2010 pode ser configurado de forma que não possam ser enviados arquivos com certas extensões (normalmente relacionadas a tipos de arquivos potencialmente perigosos).

A capacidade dos usuários transferirem arquivos utilizando clientes Lync Server 2010 é determinada pelas definições de configuração de filtros de transferência de arquivos aplicadas no escopo global ou (opcionalmente) de site. O cmdlet Set-CsFileTransferFilterConfiguration permite modificar uma configuração existente de filtros de transferência de arquivos. Pode-se modificar a lista de extensões que serão bloqueadas, pela adição ou remoção de extensões, ou pela criação de uma nova lista. Pode-se também utilizar este cmdlet para ativar ou desativar a filtragem de transferência de arquivos, e especificar o nível de bloqueio (somente os arquivos cujas extensões coincidirem com a lista de extensões ou todos os arquivos).

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

Cadeia de caracteres

Um identificador exclusivo da configuração de transferência de arquivos que se deseja modificar. Esse valor será global ou do site:<nome do site>, onde <nome do site> é o nome do site ao qual as definições se aplicam, como site:Redmond.

Se este parâmetro não for especificado, Set-CsFileTransferFilterConfiguration, por padrão, atualizará as definições globais.

Instance

Opcional

FileTransferFilterConfiguration

Permite passar uma referência a um objeto para o cmdlet, em vez de definir valores de parâmetros individuais. Este objeto deve ser do tipo FileTransferFilterConfiguration e pode ser recuperado chamando-se o cmdlet Get-CsFileTransferFilterConfiguration.

Action

Opcional

Cadeia de caracteres

Determina a ação a ser tomada se esta configuração de transferência de arquivos estiver habilitada. Se definidas como BlockAll, então todas as transferências de arquivos vão ser proibidas, independente da extensão do arquivo. Se definidas como Block (o valor padrão), transferências de arquivos vão ser permitidas a menos que a extensão do arquivo apareça como um dos tipos de arquivo proibidos listado na propriedade Extensions.

Para autorizar transferência de arquivos irrestrita (isto é, para permitir que os usuários troquem qualquer tipo de arquivo, independentemente do tipo de extensão), defina como False a propriedade Enabled desta política.

Enabled

Opcional

Booleano

Habilita ou desabilita filtro de transferência de arquivos. Se este parâmetro estiver definido como True, os arquivos com as extensões especificadas (ou todos os arquivos, dependendo do valor da propriedade Action) não poderão ser transferidos do cliente. Se este parâmetro estiver definido como False, qualquer arquivo poderá ser transferido.

Padrão: True.

Extensions

Opcional

Lista de cadeias de caracteres

Lista de extensões de arquivos que serão bloqueados. Se você tentar usar um cliente Lync Server 2010 para transferir um arquivo cuja extensão de arquivo corresponder a uma das extensões nesta lista, essa transferência será bloqueada e o arquivo não será transferido. Esta lista é ignorada se Action for definida como BlockAll (todas as transferências de arquivo são bloqueadas) ou se Enabled for definida como False (nenhuma transferência de arquivo é bloqueada).

Por padrão, as seguintes extensões de arquivos estão incluídas no padrão da propriedade Extensions: .ade, .adp, .app, .asp, .bas, .bat, .cer, .chm, .cmd, .com, .cpl, .crt, .csh, .exe, .fxp, .grp, .hlp, .hta, .inf, .ins, .isp, .its, .js, .jse, .ksh, .lnk, .mad, .maf, .mag, .mam, .maq, .mar., mas., .mat, .mau, .mav, .maw, .mda, .mdb. .mde, .mdt, .mdw, .mdz, .msc, .msi, .msp, .mst, .ocx, .ops, .pcd, .pif, .pl, .pnp, .prf, .prg, .pst, .reg, .scf, .scr, .sct, .shb, .shs, .tmp, .url, .vb, .vbe, .vbs, .vsd, .vsmacros, .vss, .vst, .vsw, .ws, .wsc. .wsf, .wsh

Force

Opcional

SwitchParameter

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

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.ImFilter.FileTransferFilterConfiguration. Aceita entradas canalizadas de objetos de configuração do filtro de transferência de arquivos.

Tipos de Retorno

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

Exemplo

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

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

O comando mostrado no Exemplo 1 desativa a filtragem de transferência de arquivos no site de Redmond (isto é, a configuração de filtros de transferência de arquivos cuja identidade for site:Redmond). Para realizar esta tarefa, inclui-se o parâmetro Enabled no comando e ele é definido como $False.

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

Set-CsFileTransferFilterConfiguration -Identity site:Redmond -Extensions @{Add=".ps1"}

Os comandos anteriores adicionam uma nova extensão de arquivo (.ps1, a extensão de scripts do Windows PowerShell) à lista de extensões proibidas no site de Redmond. Para adicionar uma nova extensão de arquivo, Set-CsFileTransferFilterConfiguration utiliza o parâmetro Extensions e o modificador Add list. O modificador adiciona a extensão de arquivo especificada (.ps1) à lista de extensões proibidas. Para adicionar múltiplas extensões utilizando um único comando, basta separá-las por vírgulas: @{Add=".ps1",".ps2",".ps3"}. Observe que o ponto deve ser incluído quando se especifica uma extensão de arquivo.

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

Get-CsFileTransferFilterConfiguration | Set-CsFileTransferFilterConfiguration -Extensions @{Add=".ps1"}

No Exemplo 3, a extensão .ps1 é adicionada à lista de Extensões em todas as configurações de filtro de transferência de arquivos em uso na organização. Para isso, primeiramente chama-se Get-CsFileTransferFilterConfiguration, sem qualquer parâmetro, para retornar uma coleção de todas as configurações de filtro de transferência de arquivos em uso. Essa coleção será, então, canalizada para Set-CsFileTransferFilterConfiguration, que adicionará a extensão de arquivo .ps1 a cada item da coleção.

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

Set-CsFileTransferFilterConfiguration -Identity site:Redmond -Extensions @{Remove=".ps1"}

No exemplo anterior, a extensão .ps1 é removida da lista de extensões bloqueadas pela configuração de filtros de transferência de arquivos do site de Redmond. Este exemplo é idêntico ao Exemplo 3, exceto pelo fato de que, em vez de chamar o modificador da lista Add para adicionar uma extensão à lista, chama-se o modificador da lista Remove para remover uma extensão da lista.

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

$a = Get-CsFileTransferFilterConfiguration -Identity site:Redmond
$a.Extensions.Remove(".ps1")
Set-CsFileTransferFilterConfiguration -Instance $a

O Exemplo 5 executa a mesma ação que o Exemplo 4: ele remove a extensão .ps1 da lista de extensões de filtro de transferência de arquivos do site de Redmond. Contudo, neste caso, primeiramente recupera-se a configuração de filtros de transferência de arquivos de site:Redmond e atribui-se a saída à variável $a, que passa a conter a configuração do site de Redmond. A seguir, recupera-se a propriedade Extensions de $a, que é a propriedade Extensions de site:Redmond ($a.Extensions). Esta propriedade contém a lista de extensões de arquivos. Depois da utilização da propriedade Extensions, efetua-se uma chamada ao método Remove ($a.Extensions.Remove). O valor .ps1 é passado ao método Remove; isto removerá essa extensão da lista na propriedade Extensions. Contudo, isto remove a extensão somente da configuração armazenada na memória, na variável $a. Para realizar esta mudança no banco de dados, é necessário chamar Set-CsFileTransferFilterConfiguration, passando $a para o parâmetro Instance.