Compartilhar via

  • Artigo

Remove-CsFileTransferFilterConfiguration

 

Tópico modificado em: 2012-03-25

Remove a configuração especificada de filtros de transferência de arquivos de mensagens instantâneas. (as definições de filtros de transferência de arquivos de mensagens instantâneas são utilizadas para impedir que o usuário transfira certos tipos de arquivos dentro de uma mensagem instantânea.)

Sintaxe

Remove-CsFileTransferFilterConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Ao enviar mensagens instantâneas, os usuários podem anexar e enviar arquivos para outros participantes da conversa. O Microsoft Lync Server 2010 pode ser configurado de forma que arquivos com determinadas extensões, normalmente relacionadas a tipos de arquivos que podem ser prejudiciais, não possam ser enviados utilizando um cliente do Lync Server 2010.

O cmdlet Remove-CsFileTransferFilterConfiguration permite excluir uma configuração de filtros de transferência de arquivos. No caso de configurações no escopo de site, Remove-CsFileTransferFilterConfiguration removerá a configuração. Por sua vez, os usuários do site herdarão automaticamente a configuração global de filtros de transferência de arquivos. Remove-CsFileTransferFilterConfiguration também pode ser executado em uma configuração global. Nesse caso, no entanto, a configuração global não será removida; em vez disso, todos os valores de propriedade nessa configuração serão redefinidos para os seus valores padrão.

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Obrigatório

XdsIdentity

Identificador exclusivo da configuração de transferência de arquivos a ser removida. Para se referir à configuração global, use esta sintaxe: -Identity global. Para se referir a uma configuração no escopo de site, utilize uma sintaxe semelhante a essa: -Identity site:Redmond. Observe que não é possível utilizar valores curinga ao se especificar uma Identidade.

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 um objeto. Em vez disso, ele remove instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.FileTransferFilterConfiguration.

Exemplo

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

Remove-CsFileTransferFilterConfiguration -Identity site:Redmond

No exemplo anterior, utiliza-se Remove-CsFileTransferFilterConfiguration para remover a configuração do filtro de transferência de arquivos que possuir a Identidade site:Redmond.

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

Get-CsFileTransferFilterConfiguration -Filter site:* | Remove-CsFileTransferFilterConfiguration

No Exemplo 2, serão removidas todas as configurações do filtro de transferência de arquivos no escopo de site. Para realizar essa tarefa, o comando primeiramente utiliza Get-CsFileTransferFilterConfiguration e o parâmetro Filter, para retornar todas as configurações no escopo de site. O valor de filtro "site:*" instrui Get-CsFileTransferFilterConfiguration a retornar somente as configurações que possuírem a identidade iniciada pelo valor da cadeia de caracteres "site:". Esta coleção filtrada de configurações será então canalizada para Remove-CsFileTransferFilterConfiguration, que excluirá cada item na coleção.

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

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

O Exemplo 3 mostra como é possível remover todas as configurações de filtros de transferência de arquivos que estiverem desabilitadas. Para fazer isso, o comando utiliza primeiramente Get-CsFileTransferFilterConfiguration, para retornar uma coleção de todas as configurações de filtros de transferência de arquivos em uso na organização. Estas informações serão então canalizadas para o cmdlet Where-Object, que selecionará apenas as configurações de filtros de transferência de arquivos cuja propriedade Enabled for igual a (-eq) False ($False). Esta coleção filtrada será então canalizada para Remove-CsFileTransferFilterConfiguration, que removerá cada item da coleção filtrada.