Set-MalwareFilterPolicy

Este parâmetro está disponível somente no Exchange local.

O parâmetro Action especifica a ação a ser tomada quando o malware é detectado em uma mensagem. Os valores válidos são:

• DeleteMessage: manipula a mensagem sem notificar os destinatários. Esse é o valor padrão.
• DeleteAttachmentAndUseDefaultAlert: entrega a mensagem, mas substitui todos os anexos por um arquivo chamado Alerta de Malware Text.txt que contém o texto de alerta padrão.
• DeleteAttachmentAndUseCustomAlert: entrega a mensagem, mas substitui todos os anexos por um arquivo chamado Alerta de Malware Text.txt que contém o texto de alerta personalizado especificado pelo parâmetro CustomAlertText.

O parâmetro AdminDisplayName especifica uma descrição para a política. Se o valor contiver espaços, coloque-o entre aspas (").

Este parâmetro está disponível somente no Exchange local.

O parâmetro BypassInboundMessages habilita ou desabilita a filtragem de malware em mensagens de entrada (mensagens que entram na organização). Os valores válidos são:

• $true: a filtragem de malware está desabilitada em mensagens de entrada.
• $false: a filtragem de malware está habilitada em mensagens de entrada. Esse é o valor padrão.

Este parâmetro está disponível somente no Exchange local.

O parâmetro BypassOutboundMessages habilita ou desabilita a filtragem de malware em mensagens de saída (mensagens saindo da organização). Os valores válidos são:

• $true: a filtragem de malware está desabilitada em mensagens de saída.
• $false: a filtragem de malware está habilitada em mensagens de saída. Esse é o valor padrão.

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.

Este parâmetro está disponível somente no Exchange local.

O parâmetro CustomAlertText especifica o texto personalizado a ser usado no anexo de substituição chamado Alerta de Malware Text.txt. Se o valor contiver espaços, coloque-o entre aspas (").

Esse parâmetro só é significativo quando o valor do parâmetro Action é DeleteAttachmentAndUseCustomAlert.

O parâmetro CustomExternalBody especifica o corpo personalizado a ser usado em mensagens de notificação para detecções de malware em mensagens de remetentes externos. Se o valor contiver espaços, coloque-o entre aspas (").

Esse parâmetro só é significativo quando o valor do parâmetro CustomNotifications é $true e o valor de pelo menos um dos seguintes parâmetros também é $true:

• EnableExternalSenderAdminNotifications
• EnableExternalSenderNotifications

O parâmetro CustomExternalSubject especifica o assunto personalizado a ser usado em mensagens de notificação para detecções de malware em mensagens de remetentes externos. Se o valor contiver espaços, coloque-o entre aspas (").

Esse parâmetro só é significativo quando o valor do parâmetro CustomNotifications é $true e o valor de pelo menos um dos seguintes parâmetros também é $true:

• EnableExternalSenderAdminNotifications
• EnableExternalSenderNotifications

O parâmetro CustomFromAddress especifica o endereço personalizado De usar em mensagens de notificação para detecções de malware em mensagens de remetentes internos ou externos.

Esse parâmetro só é significativo quando o valor do parâmetro CustomNotifications é $true e o valor de pelo menos um dos seguintes parâmetros também é $true:

• EnableExternalSenderAdminNotifications
• EnableExternalSenderNotifications
• HabilitarInternalSenderAdminNotifications
• HabilitarInternalSenderNotifications

O parâmetro CustomFromName especifica o nome personalizado a ser usado em mensagens de notificação para detecções de malware em mensagens de remetentes internos ou externos. Se o valor contiver espaços, coloque-o entre aspas (").

Esse parâmetro só é significativo quando o valor do parâmetro CustomNotifications é $true e o valor de pelo menos um dos seguintes parâmetros também é $true:

• EnableExternalSenderAdminNotifications
• EnableExternalSenderNotifications
• HabilitarInternalSenderAdminNotifications
• HabilitarInternalSenderNotifications

O parâmetro CustomInternalBody especifica o corpo personalizado a ser usado em mensagens de notificação para detecções de malware em mensagens de remetentes internos. Se o valor contiver espaços, coloque-o entre aspas (").

Esse parâmetro só é significativo quando o valor do parâmetro CustomNotifications é $true e o valor de pelo menos um dos seguintes parâmetros também é $true:

• HabilitarInternalSenderAdminNotifications
• HabilitarInternalSenderNotifications

O parâmetro CustomInternalSubject especifica o sujeito personalizado a ser usado em mensagens de notificação para detecções de malware em mensagens de remetentes internos. Se o valor contiver espaços, coloque-o entre aspas (").

Esse parâmetro só é significativo quando o valor do parâmetro CustomNotifications é $true e o valor de pelo menos um dos seguintes parâmetros também é $true:

• HabilitarInternalSenderAdminNotifications
• HabilitarInternalSenderNotifications

O parâmetro CustomNotifications habilita ou desabilita a personalização de mensagens de notificação para detecções de malware. Os valores válidos são:

• $true: substitua os valores padrão usados em mensagens de notificação pelos valores dos parâmetros CustomFromAddress, CustomFromName, CustomExternalSubject, CustomExternalBody, CustomInternalSubject e CustomInternalBody.
• $false: nenhuma personalização é feita para mensagens de notificação. Os valores padrão são usados.

Esse parâmetro só é significativo quando o valor de pelo menos um dos seguintes parâmetros também é $true:

• EnableExternalSenderAdminNotifications
• EnableExternalSenderNotifications
• HabilitarInternalSenderAdminNotifications
• HabilitarInternalSenderNotifications

Este parâmetro está disponível somente no Exchange local.

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 EnableExternalSenderAdminNotifications habilita ou desabilita o envio de mensagens de notificação a um administrador para detecções de malware em mensagens de remetentes internos. Os valores válidos são:

• $true: quando anexos de malware são detectados em mensagens de remetentes externos, uma mensagem de notificação é enviada para o endereço de email especificado pelo parâmetro ExternalSenderAdminAddress.
• $false: as notificações não são enviadas para detecções de anexo de malware em mensagens de remetentes externos. Esse é o valor padrão.

Observação: Administração notificações são enviadas apenas para anexos classificados como malware.

Este parâmetro está disponível somente no Exchange local.

O parâmetro EnableExternalSenderNotifications habilita ou desabilita o envio de mensagens de notificação para remetentes externos para detecções de malware em suas mensagens. Os valores válidos são:

• $true: quando o malware é detectado em uma mensagem de um remetente externo, envie-lhes uma mensagem de notificação.
• $false: não envie mensagens de notificação de detecção de malware para remetentes de mensagens externas. Esse é o valor padrão.

Esse parâmetro só está disponível no serviço baseado em nuvem.

O parâmetro EnableFileFilter habilita ou desabilita o filtro de anexos comuns (também conhecido como bloqueio de anexo comum). Os valores válidos são:

• $true: o filtro de anexos comuns está habilitado. Os tipos de arquivo são especificados pelo parâmetro FileTypes.
• $false: o filtro de anexos comuns está desabilitado. Esse é o valor padrão.

O parâmetro EnableInternalSenderAdminNotifications habilita ou desabilita o envio de mensagens de notificação a um administrador para detecções de malware em mensagens de remetentes internos. Os valores válidos são:

• $true: quando anexos de malware são detectados em mensagens de remetentes internos, uma mensagem de notificação é enviada para o endereço de email especificado pelo parâmetro InternalSenderAdminAddress.
• $false: as notificações não são enviadas para detecções de anexo de malware em mensagens de remetentes internos. Esse é o valor padrão.

Observação: Administração notificações são enviadas apenas para anexos classificados como malware.

Este parâmetro está disponível somente no Exchange local.

O parâmetro EnableInternalSenderNotifications habilita ou desabilita o envio de mensagens de notificação para remetentes internos para detecções de malware em suas mensagens. Os valores válidos são:

• $true: quando o malware é detectado em uma mensagem de um remetente interno, envie-lhes uma mensagem de notificação.
• $false: não envie mensagens de notificação de detecção de malware para remetentes de mensagens internas. Esse é o valor padrão.

O parâmetro ExternalSenderAdminAddress especifica o endereço de email do administrador que recebe mensagens de notificações para detecções de malware em mensagens de remetentes externos.

Esse parâmetro só será significativo se o valor do parâmetro EnableExternalSenderAdminNotifications for $true.

Esse parâmetro só está disponível no serviço baseado em nuvem.

O parâmetro FileTypeAction especifica o que acontece com mensagens que contêm um ou mais anexos em que a extensão do arquivo está incluída no parâmetro FileTypes (o filtro de anexos comuns). Os valores válidos são:

• Quarentena: coloque em quarentena a mensagem. Se o destinatário é notificado ou não depende das configurações de notificação de quarentena na política de quarentena selecionada para a política pelo parâmetro QuarantineTag.
• Rejeição: a mensagem é rejeitada em um relatório de não entrega (também conhecido como NDR ou mensagem de salto) para o remetente. A mensagem não está disponível em quarentena. Esse é o valor padrão.

Esse parâmetro só é significativo quando o valor do parâmetro EnableFileFilter é $true.

Esse parâmetro só está disponível no serviço baseado em nuvem.

O parâmetro FileTypes especifica os tipos de arquivo bloqueados automaticamente pelo filtro de anexos comuns, independentemente do conteúdo. No entanto, isso é recomendável somente em ambientes entre florestas.

ace, ani, apk, app, appx, arj, bat, cab, cmd, com, deb, dex, dll, docm, elf, exe, hta, img, iso, jar, jnlp, kext, lha, lib, library, lnk, lzh, macho, msc, msi, msix, msp, mst, pif, ppa, ppam, reg, rev, scf, scr, sct, sys, uif, vb, vbe, vbs, vxd, wsc, wsf, wsh, xll, xz, z

Esse parâmetro só será significativo se o valor do parâmetro EnableFileFilter for $true.

O filtro de anexos comuns usa a melhor digitação true de esforço para detectar o tipo de arquivo, independentemente da extensão do nome do arquivo. Se a digitação true falhar ou não tiver suporte para o tipo de arquivo especificado, a correspondência de extensão será usada. Por exemplo, .ps1 arquivos são Windows PowerShell scripts, mas seu tipo verdadeiro é texto.

Para substituir a lista existente de tipos de arquivo pelos valores especificados, use a sintaxe FileType1,FileType2,...FileTypeN. Para preservar os valores existentes, certifique-se de incluir os tipos de arquivo que você deseja manter junto com os novos valores que você deseja adicionar.

Para adicionar ou remover tipos de arquivo sem afetar as outras entradas do tipo de arquivo, consulte a seção Exemplos no tópico cmdlet Set-MalwareFilterPolicy.

O parâmetro Identidade especifica a política de filtro de malware que você deseja modificar. É possível usar qualquer valor que identifique a política com exclusividade. Por exemplo:

• Nome
• DN (nome diferenciado)
• GUID

O parâmetro InternalSenderAdminAddress especifica o endereço de email do administrador que recebe mensagens de notificações para detecções de malware em mensagens de remetentes internos.

Esse parâmetro só será significativo se o valor do parâmetro EnableInternalSenderAdminNotifications for $true.

A opção MakeDefault faz dessa política de filtro de malware a política padrão. Não é preciso especificar um valor com essa opção.

A política de filtro de malware padrão não tem filtros de destinatário (é aplicada a todos) e tem o valor de prioridade mais baixo.

Esse parâmetro só está disponível no serviço baseado em nuvem.

O parâmetro QuarantineTag especifica a política de quarentena usada em mensagens que são colocadas em quarentena como malware. Você pode usar qualquer valor que identifique exclusivamente a política de quarentena. Por exemplo:

• Nome
• DN (nome diferenciado)
• GUID

As políticas de quarentena definem o que os usuários podem fazer para mensagens em quarentena e se os usuários recebem notificações de quarentena. Para obter mais informações sobre políticas de quarentena, consulte Políticas de quarentena.

A política de quarentena padrão usada é chamada AdminOnlyAccessPolicy. Para obter mais informações sobre essa política de quarentena, consulte Anatomia de uma política de quarentena.

Para exibir a lista de políticas de quarentena disponíveis, execute o seguinte comando: Get-QuarantinePolicy | Format-List Name,EndUser*,ESNEnabled.

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.

Esse parâmetro só está disponível no serviço baseado em nuvem.

O parâmetro ZapEnabled habilita ou desabilita ZAP (limpeza automática) de zero hora para malware em caixas de correio de nuvem. O ZAP detecta malware em mensagens não lidas que já foram entregues na caixa de entrada do usuário. Os valores válidos são:

• $true: o ZAP para malware está habilitado. Esse é o valor padrão. Em Exchange Server, mensagens não lidas na caixa de entrada do usuário que contêm malware são movidas para a pasta Junk Email. No serviço baseado em nuvem, as mensagens são colocadas em quarentena.
• $false: o ZAP para malware está desabilitado.