New-EOPProtectionPolicyRule
Esse cmdlet só está disponível no serviço baseado em nuvem.
Utilize o cmdlet New-EOPProtectionPolicyRule para criar regras para as funcionalidades de segurança incorporadas para todas as caixas de correio na nuvem em políticas de segurança predefinidas. As regras especificam as condições e exceções do destinatário para a proteção e também lhe permitem ativar e desativar as políticas de segurança predefinidas associadas.
Nota: a menos que tenha removido manualmente uma regra com o cmdlet Remove-EOPProtectionPolicyRule, não recomendamos que utilize este cmdlet para criar regras. Para criar a regra, tem de especificar as políticas de segurança individuais existentes que estão associadas à política de segurança predefinida. Nunca recomendamos a criação manual destas políticas de segurança individuais necessárias. Ativar a política de segurança predefinida pela primeira vez no portal do Microsoft Defender cria automaticamente as políticas de segurança individuais necessárias, mas também cria as regras associadas com este cmdlet. Por isso, se as regras já existirem, não precisa de utilizar este cmdlet para as criar.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Default)
New-EOPProtectionPolicyRule
[-Name] <String>
[-Priority <Int32>]
-AntiPhishPolicy <AntiPhishPolicyIdParameter>
-HostedContentFilterPolicy <HostedContentFilterPolicyIdParameter>
-MalwareFilterPolicy <MalwareFilterPolicyIdParameter>
[-Comments <String>]
[-Confirm]
[-Enabled <Boolean>]
[-ExceptIfRecipientDomainIs <Word[]>]
[-ExceptIfSentTo <RecipientIdParameter[]>]
[-ExceptIfSentToMemberOf <RecipientIdParameter[]>]
[-RecipientDomainIs <Word[]>]
[-SentTo <RecipientIdParameter[]>]
[-SentToMemberOf <RecipientIdParameter[]>]
[-WhatIf]
[<CommonParameters>]
Description
Para obter mais informações sobre as políticas de segurança predefinidas no PowerShell, veja Predefinições de políticas de segurança no Exchange Online PowerShell.
Importante
Os diferentes tipos de condições do destinatário utilizam a lógica AND (o destinatário tem de satisfazer todas as condições especificadas). Diferentes tipos de exceções de destinatários utilizam lógica OR (o destinatário tem de satisfazer qualquer uma das exceções especificadas). Para obter mais informações, veja Perfis em políticas de segurança predefinidas.
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
New-EOPProtectionPolicyRule -Name "Standard Preset Security Policy" -AntiPhishPolicy "Standard Preset Security Policy1622650005393" -HostedContentFilterPolicy "Standard Preset Security Policy1622650006407" -MalwareFilterPolicy "Standard Preset Security Policy1622650007658" Priority 1
Este exemplo cria a regra para a política de segurança predefinida Standard. Não são impostas restrições sobre a quem se aplicam as proteções do Defender para Office 365. Se a regra já existir, o comando falhará.
Parâmetros
-AntiPhishPolicy
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro AntiPhishPolicy especifica a política anti-phishing existente associada à política de segurança predefinida.
Se alguma vez tiver ativado a política de segurança predefinida no portal Microsoft Defender, o nome da política anti-phishing é um dos seguintes valores:
- Standard número de 13 dígitos da Política<de Segurança Predefinida>. Por exemplo,
Standard Preset Security Policy1622650005393. - Estrita Política<de Segurança Predefinida número de 13 dígitos>. Por exemplo,
Strict Preset Security Policy1642034844713.
Pode encontrar a política anti-phishing utilizada pelas políticas de segurança predefinidas Standard ou Estritas ao executar os seguintes comandos: Get-AntiPhishPolicy | Where-Object -Property RecommendedPolicyType -eq -Value "Standard" ou AntiPhishPolicy | Where-Object -Property RecommendedPolicyType -eq -Value "Strict".
Propriedades do parâmetro
| Tipo: | AntiPhishPolicyIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Comments
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro Comments especifica comentários informativos para a regra, como a finalidade de uso da regra ou as respectivas mudanças ao longo do tempo. O tamanho do comentário não pode exceder 1024 caracteres.
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 |
-Confirm
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
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 esses cmdlets, você pode ignorar a solicitação 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 |
-Enabled
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro Ativado especifica se a regra está ativada. Os valores válidos são:
- $true: a regra está ativada. O valor Estado da regra é Ativado. Este valor é a predefinição.
- $false: a regra está desativada. O valor Estado da regra é Desativado.
Depois de criar a regra, ative ou desative a política de segurança predefinida com um dos seguintes comandos:
- Desativar: Disable-EOPProtectionPolicyRule.
- Ative: Enable-EOPProtectionPolicyRule.
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 |
-ExceptIfRecipientDomainIs
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro ExceptIfRecipientDomainIs especifica uma exceção que procura destinatários com endereços de e-mail nos domínios especificados. É possível especificar vários domínios, separando-os por vírgulas.
Propriedades do parâmetro
| Tipo: | Word[] |
| 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 |
-ExceptIfSentTo
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro ExceptIfSentTo especifica uma exceção que procura destinatários nas mensagens. É possível usar qualquer valor que identifique o destinatário com exclusividade. Por exemplo:
- Nome
- Alias
- Nome diferenciado (DN)
- Nome diferenciado (DN)
- DN canônico
- GUID
Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
Propriedades do parâmetro
| Tipo: | RecipientIdParameter[] |
| 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 |
-ExceptIfSentToMemberOf
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro ExceptIfSentToMemberOf especifica uma exceção que procura mensagens enviadas para membros de grupos. É possível usar qualquer valor que identifique o grupo com exclusividade. Por exemplo:
- Nome
- Alias
- Nome diferenciado (DN)
- Nome diferenciado (DN)
- DN canônico
- GUID
Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
PD_UCC_Multiple_Values
Propriedades do parâmetro
| Tipo: | RecipientIdParameter[] |
| 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 |
-HostedContentFilterPolicy
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro HostedContentFilterPolicy especifica a política anti-spam existente associada à política de segurança predefinida.
Se alguma vez tiver ativado a política de segurança predefinida no portal Microsoft Defender, o nome da política antisspessoal é um dos seguintes valores:
- Standard número de 13 dígitos da Política<de Segurança Predefinida>. Por exemplo,
Standard Preset Security Policy1622650006407. - Estrita Política<de Segurança Predefinida número de 13 dígitos>. Por exemplo,
Strict Preset Security Policy1642034847393.
Pode encontrar a política antisspam utilizada pelas políticas de segurança predefinidas Standard ou Estritas ao executar os seguintes comandos: Get-HostedContentFilterPolicy | Where-Object -Property RecommendedPolicyType -eq -Value "Standard" ou Get-HostedContentFilterPolicy | Where-Object -Property RecommendedPolicyType -eq -Value "Strict".
Propriedades do parâmetro
| Tipo: | HostedContentFilterPolicyIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-MalwareFilterPolicy
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro HostedContentFilterPolicy especifica a política antimalware existente associada à política de segurança predefinida.
Se alguma vez tiver ativado a política de segurança predefinida no portal Microsoft Defender, o nome da política antimalware é um dos seguintes valores:
- Standard número de 13 dígitos da Política<de Segurança Predefinida>. Por exemplo,
Standard Preset Security Policy1622650007658. - Estrita Política<de Segurança Predefinida número de 13 dígitos>. Por exemplo,
Strict Preset Security Policy1642034871908.
Pode encontrar a política antimalware utilizada pelas políticas de segurança predefinidas Standard ou Estritas ao executar os seguintes comandos: Get-MalwareFilterPolicy | Where-Object -Property RecommendedPolicyType -eq -Value "Standard" ou Get-MalwareFilterPolicy | Where-Object -Property RecommendedPolicyType -eq -Value "Strict".
Propriedades do parâmetro
| Tipo: | MalwareFilterPolicyIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Name
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro Name especifica um nome exclusivo para a regra. O tamanho máximo é de 64 caracteres.
Por predefinição, as regras são denominadas Standard Política de Segurança Predefinida ou Política de Segurança Predefinida Rigorosa. Uma vez que não precisa de criar regras que não as utilizadas pela política de segurança predefinida Standard ou pela política de segurança predefinida Estrita, recomendamos vivamente que utilize os nomes de regras predefinidos para maior clareza e consistência.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Priority
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro Priority especifica um valor de prioridade para a regra que determina a ordem do processamento de regras. Um valor inteiro mais baixo indica uma prioridade mais alta, o valor 0 é a prioridade mais alta, e as regras não podem ter o mesmo valor de prioridade.
O valor predefinido para a regra associada à política de segurança predefinida Estrita é 0 e o valor predefinido para a regra que está associada à Standard política de segurança predefinida é 1.
Quando cria a política, tem de utilizar o valor predefinido.
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 |
-RecipientDomainIs
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro RecipientDomainIs especifica uma condição que procura destinatários com endereços de e-mail nos domínios especificados. É possível especificar vários domínios, separando-os por vírgulas.
Propriedades do parâmetro
| Tipo: | Word[] |
| 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 |
-SentTo
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro SentTo especifica uma condição que procura destinatários em mensagens. É possível usar qualquer valor que identifique o destinatário com exclusividade. Por exemplo:
- Nome
- Alias
- Nome diferenciado (DN)
- Nome diferenciado (DN)
- DN canônico
- GUID
Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
Propriedades do parâmetro
| Tipo: | RecipientIdParameter[] |
| 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 |
-SentToMemberOf
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro SentToMemberOf especifica uma condição que procura mensagens enviadas para membros de grupos de distribuição, grupos de distribuição dinâmicos ou grupos de segurança com capacidade de correio. É possível usar qualquer valor que identifique o grupo com exclusividade. Por exemplo:
- Nome
- Alias
- Nome diferenciado (DN)
- Nome diferenciado (DN)
- DN canônico
- GUID
Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
PD_UCC_Multiple_Values
Propriedades do parâmetro
| Tipo: | RecipientIdParameter[] |
| 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 Online, Suplemento de segurança incorporado para caixas de correio no local
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.