Compartilhar via

  • Artigo

New-CsFileTransferFilterConfiguration

 

Tópico modificado em: 2012-03-26

Criar uma nova configuração de filtro de transferência de arquivos. As configurações de filtro de transferência de arquivos 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

New-CsFileTransferFilterConfiguration -Identity <XdsIdentity> [-Action <BlockAll | Block>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Extensions <PSListModifier>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<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 os arquivos com certas extensões — tipicamente extensões de arquivos que possam ser potencialmente nocivos — não tenham autorização para serem enviados usando um cliente do Lync Server 2010.

Quando você instala o Lync Server 2010, uma única configuração de filtro de transferência de arquivos (configurada no escopo global) é criada para você. Por padrão, a configuração global se aplica a todos os usuários na sua organização. Também é possível usar o cmdlet New-CsFileTransferFilterConfiguration para criar configurações de filtro de transferência de arquivos para sites individuais. Se existir uma configuração para um certo site, estas configurações de transferência de arquivos vão ser aplicadas a todos os usuários deste site. Se esta coleção não existir para um site, então as configurações globais vão ser aplicadas ao invés.

Observe que não é possível criar uma nova configuração de filtro de transferência de arquivos no escopo global; no entanto, você pode usar o cmdlet Set-CsFileTransferFilterConfiguration para modificar as configurações globais. Da mesma forma, você não pode criar uma nova configuração para um site que já tenha uma definida; se tentar, o comando vai falhar.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

XdsIdentity

Identificador exclusivo a ser atribuído à configuração de filtro de transferência de arquivos. A Identidade da nova configuração é simplesmente o prefixo "site:" seguido do nome do site. Por exemplo, para criar uma nova configuração para o site Redmond, use esta sintaxe: -Identity site:Redmond.

Action

Opcional

Cadeia de caracteres

Determina a ação a ser tomada se a filtragem 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, independente do tipo de extensão) defina a propriedade Enabled desta diretiva para False.

Enabled

Opcional

Booleano

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

Padrão: True.

Extensions

Opcional

PSListModifier

Lista de extensões de arquivos que vão ser bloqueados. Se você tentar usar um cliente do Lync Server 2010 para transferir um arquivo com extensão correspondente a uma das extensões na lista, a transferência vai ser bloqueada e o arquivo não vai 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 são incluídas na 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 todos os avisos de confirmação que seriam exibidos antes que as alterações sejam feitas.

InMemory

Opcional

Parâmetros de Opção

Cria uma referência de objeto, sem na verdade executar o objeto como uma alteração permanente. Se a saída deste cmdlet for atribuída, chamando-o com este parâmetro a uma variável, você poderá realizar alterações às propriedades da referência do objeto e executar estas alterações, chamando-se o cmdlet coincidente Set- deste cmdlet.

WhatIf

Opcional

Parâmetros de Opção

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Opcional

Parâmetros de Opção

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Nenhuma.

Tipos de Retorno

New-CsFileTransferFilterConfiguration cria novas instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.FileTransferFilterConfiguration.

Exemplo

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

New-CsFileTransferFilterConfiguration -Identity site:Redmond

No comando anterior, New-CsFileTransferFilterConfiguration é usado para criar uma nova configuração do filtro de transferência de arquivo de mensagens instantâneas com a Identidade site:Redmond. Como não foram especificados parâmetros adicionais, as configurações serão criadas usando os valores padrão.

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

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

Neste comando, New-CsFileTransferFilterConfiguration é usado para criar uma nova configuração do filtro de transferência de arquivos com a Identidade site:Redmond. Porque o parâmetro Extensions foi especificado, a nova configuração vai conter todos os valores padrões mais uma extensão de arquivo adicional: .ps1. Esta nova extensão é adicionada usando o parâmetro Extensions e o modificador de lista Add seguido da extensão de arquivo a ser adicionada. (Note que você precisa incluir o ponto como parte da extensão do arquivo). Para adicionar múltiplas extensões de arquivos, simplesmente separe estas extensões usando vírgula: @{Add=".ps1",".ps2",".ps3"}

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

New-CsFileTransferFilterConfiguration -Identity site:Redmond -Extensions @{Replace=".vbs",".ps1"}

No Exemplo 3, New-CsFileTransferFilterConfiguration é usado para criar uma nova configuração do filtro de transferência de arquivos com a Identidade site:Redmond. Este exemplo é semelhante ao Exemplo 2, exceto que o modificador de lista Replace foi usado ao invés do modificador Add. Isto significa que o grupo completo de extensões de arquivos vai ser substituído pelas duas extensões especificadas: .vbs e .ps1. Neste caso, os únicos arquivos bloqueados no site Redmond serão .vbs e .ps1.

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

$x = New-CsFileTransferFilterConfiguration -Identity site:Redmond -InMemory 
$x.Action = "BlockAll"
Set-CsFileTransferFilterConfiguration -Instance $x

O Exemplo 4 demonstra o uso do parâmetro InMemory para criar uma configuração de filtro de transferência de arquivos que inicialmente reside na memória apenas. Para fazer isto, o primeiro comando no exemplo usa New-CsFileTransferFilterConfiguration e o parâmetro InMemory para criar uma nova configuração de filtro de transferência de arquivos com a Identidade site:Redmond. Neste momento, as novas configurações existem apenas na memória; usuários no site Redmond ainda vão ser governados pelas configurações de filtro de transferência de arquivos global.

No segundo comando, o valor da propriedade Action para esta instância em memória é definida como BlockAll. Finalmente, o terceiro comando no exemplo usa Set-CsFileTransferFilterConfiguration para criar a nova coleção de configurações e aplicá-las ao site Redmond.

Observe que a mesma tarefa pode ser realizada em uma única etapa com o seguinte comando:

New-CsFileTransferFilterConfiguration -Identity site:Redmond –Action "BlockAll"