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.
Syntax
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 tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. 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 10Este 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
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 padrão é $false.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Confirm
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, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false. - A maioria dos outros cmdlets (por exemplo, cmdlets 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.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DeferAttempts
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, começando após a última tentativa deferimento, a primeira tentativa de repetição ocorrerá em 1 hora, a próxima tentativa de repetição ocorrerá 2 horas depois, a próxima tentativa de repetição irá ocorrer 3 horas após a repetição da segunda tentativa, e assim por diante por 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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DeferWaitTime
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 por diante. 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. Isso significa que o primeiro reenviamento ocorre 5 minutos após a verificação original com falha, 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 por diante. 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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainController
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.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ForceRescan
O parâmetro ForceRescan especifica que as mensagens devem ser examinadas pelo agente de malware, mesmo que a mensagem já tenha sido digitalizada por Proteção do Exchange Online. A entrada válida para esse parâmetro é $true ou $false. O valor padrão é $false.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Identity
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
| Type: | MalwareFilteringServerIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-MinimumSuccessfulEngineScans
Esse parâmetro está reservado para uso interno da Microsoft.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-PrimaryUpdatePath
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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ScanErrorAction
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.
| Type: | MalwareScanErrorAction |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ScanTimeout
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).
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-SecondaryUpdatePath
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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-UpdateFrequency
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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-UpdateTimeout
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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-WhatIf
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.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
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.
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de