Set-MalwareFilteringServer
Este cmdlet está disponível somente no Exchange local.
Use o cmdlet Set-MalwareFilteringServer para definir as configurações do agente de Malware no serviço de Transporte em um servidor de Caixa de Correio.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Padrão)
Set-MalwareFilteringServer
[-Identity] <MalwareFilteringServerIdParameter>
[-BypassFiltering <Boolean>]
[-Confirm]
[-DeferAttempts <Int32>]
[-DeferWaitTime <Int32>]
[-DomainController <Fqdn>]
[-ForceRescan <Boolean>]
[-MinimumSuccessfulEngineScans <Int32>]
[-PrimaryUpdatePath <String>]
[-ScanErrorAction <MalwareScanErrorAction>]
[-ScanTimeout <Int32>]
[-SecondaryUpdatePath <String>]
[-UpdateFrequency <Int32>]
[-UpdateTimeout <Int32>]
[-WhatIf]
[<CommonParameters>]
Description
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.
Exemplos
Exemplo 1
Set-MalwareFilteringServer Mailbox01 -UpdateFrequency 120 -DeferWaitTime 10
Este exemplo define as seguintes configurações do agente de Malware no servidor de Caixa de Correio chamado Mailbox01:
- Define o intervalo de frequência de atualização para 2 horas
- Define o tempo de espera entre tentativas de reenvio para 10 minutos
Parâmetros
-BypassFiltering
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro BypassFiltering ignora temporariamente a filtragem de malware sem desabilitar o agente de Malware no servidor. O agente de Malware ainda está ativo e o agente ainda é chamado para cada mensagem, mas nenhuma filtragem de malware é realmente executada. Isso permite que você desabilite temporariamente e depois habilite a filtragem de malware no servidor sem interromper o fluxo de mensagens reiniciando o serviço Microsoft Exchange Transport. A entrada válida para esse parâmetro é $true ou $false. O valor predefinido é $false.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Confirm
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.
- Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false. - A maioria dos outros cmdlets (por exemplo, New- e Set-) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DeferAttempts
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro DeferAttempts especifica o número máximo de vezes para adiar uma mensagem que não pode ser verificada pelo agente de Malware. A entrada válida para esse parâmetro é um número inteiro entre 1 e 5. O valor padrão é 3.
Depois que for atingido o número máximo de deferimentos, a ação tomada pelo agente de Malware varia de acordo com o erro. Para erros de tempos limite e mecanismo de varredura, a ação é deixar a mensagem e retornar um relatório de não-entrega (NDR) ao remetente imediatamente após a última tentativa de deferimento. Para todos os outros erros, a mensagem é repetida por até 48 horas, com cada tentativa de repetição ocorrendo 1 hora a mais do que a última. Por exemplo, a partir da última tentativa de diferimento, a primeira tentativa de repetição ocorre em 1 hora, a próxima tentativa de repetição ocorre 2 horas depois, a próxima tentativa de repetição ocorre 3 horas após a segunda tentativa de repetição e assim sucessivamente até 48 horas. Após 48 horas, a ação é deixar a mensagem e retornar um relatório de não-entrega (NDR) ao remetente.
Propriedades do parâmetro
| Tipo: | Int32 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DeferWaitTime
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro DeferWaitTime especifica o período de tempo em minutos para aumentar o intervalo para reenvio de mensagens para filtragem de malware em um esforço de reduzir a carga de trabalho no servidor.
Por exemplo, a primeira repetição após a falha da verificação original ocorre após o intervalo especificado pelo parâmetro DeferWaitTime. A segunda nova tentativa após a primeira repetição ocorre depois de duas vezes o valor do parâmetro DeferWaitTime. A terceira repetição após a segunda repetição ocorre após três vezes o valor do parâmetro DeferWaitTime e assim sucessivamente. O número máximo de tentativas é controlado pelo parâmetro DeferAttempts.
A entrada válida para esse parâmetro é um número inteiro entre 0 e 15. O valor padrão é 5. Isto significa que a primeira nova subscrição ocorre 5 minutos após a análise falhada original, a segunda repetição ocorre 10 minutos após a primeira repetição, a terceira repetição ocorre 15 minutos após a segunda repetição e assim sucessivamente. O valor 0 significa que as mensagens são reenviadas para filtragem de malware após as tentativas fracassadas de verificação sem qualquer atraso.
Propriedades do parâmetro
| Tipo: | Int32 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DomainController
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.
O parâmetro DomainController não é compatível com os servidores de Transporte do Microsoft Edge. Um servidor de Transporte do Microsoft Edge usa a instância local dos Serviços AD LDS para ler e gravar dados.
Propriedades do parâmetro
| Tipo: | Fqdn |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ForceRescan
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro ForceRescan especifica que as mensagens devem ser analisadas pelo agente de software maligno, mesmo que a mensagem já tenha sido analisada pela proteção baseada na cloud. Os valores válidos são:
- $true: as mensagens de organizações baseadas na cloud são analisadas pelo agente de software maligno.
- $false: as mensagens de organizações baseadas na cloud não são analisadas pelo agente de software maligno. Este valor é a predefinição.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Identity
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro Identity especifica o servidor no qual você deseja definir as configurações anti-malware. É possível usar qualquer valor que identifique o servidor com exclusividade. Por exemplo:
- Nome
- FQDN
- DN (nome diferenciado)
- DN Herdado do Exchange
Propriedades do parâmetro
| Tipo: | MalwareFilteringServerIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-MinimumSuccessfulEngineScans
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
Esse parâmetro está reservado para uso interno da Microsoft.
Propriedades do parâmetro
| Tipo: | Int32 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PrimaryUpdatePath
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro PrimaryUpdatePath especifica onde baixar atualizações de mecanismo de verificação de malware. O valor padrão é http://forefrontdl.microsoft.com/server/scanengineupdate. O local especificado pelo parâmetro PrimaryUpdatePath é sempre tentado em primeiro lugar.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ScanErrorAction
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro ScanErrorAction especifica a ação a tomar quando uma mensagem não pode ser verificada pelo filtro de malware. Os valores válidos para este parâmetro são Block ou Allow. O valor padrão é Block.
Propriedades do parâmetro
| Tipo: | MalwareScanErrorAction |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ScanTimeout
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro ScanTimeout especifica o intervalo de tempo limite, em segundos, para mensagens que não podem ser verificadas pelo filtro de malware. A entrada válida para esse parâmetro é um número inteiro entre 10 e 900. O valor padrão é 300 (5 minutos).
Propriedades do parâmetro
| Tipo: | Int32 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SecondaryUpdatePath
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro SecondaryUpdatePath especifica um local alternativo de download de atualizações de mecanismo de verificação de malware. Os valores padrão estão em branco ($null). Isso significa que nenhum local de download alternativo é especificado.
O local de download alternativo é usado quando o local especificado pelo parâmetro PrimaryUpdatePath não está disponível para o período de tempo especificado pelo parâmetro UpdateTimeout. Na próxima atualização do mecanismo de verificação de malware, o local especificado pelo parâmetro do caminho PrimaryUpdate recebe a primeira tentativa.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-UpdateFrequency
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro UpdateFrequency especifica o intervalo de frequência, em minutos, para verificar se há atualizações do mecanismo de verificação de malware. A entrada válida para esse parâmetro é um número inteiro entre 1 e 38880 (27 dias). O valor padrão é 60 (uma hora). Os locais para verificar as atualizações são especificados pelos parâmetros PrimaryUpdatePath e SecondaryUpdatePath.
Propriedades do parâmetro
| Tipo: | Int32 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-UpdateTimeout
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro UpdateTimeout especifica o intervalo de tempo limite, em segundos, para usar ao verificar atualizações do mecanismo de verificação de malware. A entrada válida para esse parâmetro é um número inteiro entre 60 e 300. O valor padrão é 150 segundos (2,5 minutos).
Se o local especificado pelo parâmetro PrimaryUpdatePath não está disponível para o período de tempo especificado pelo valor do parâmetro UpdateTimeout, será usado o local especificado pelo parâmetro SecondaryUpdatePath.
Propriedades do parâmetro
| Tipo: | Int32 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.
Entradas
Input types
Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.
Saídas
Output types
Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.