New-ATPBuiltInProtectionRule
Esse cmdlet só está disponível no serviço baseado em nuvem.
Nota: não utilize este cmdlet. Este cmdlet é utilizado pelo sistema para criar a única regra para a política de segurança predefinida de proteção incorporada durante a criação da organização. Não pode utilizar este cmdlet se já existir uma regra para a política de segurança predefinida de proteção incorporada. O cmdlet Remove-ATPBuiltInProtectionRule não está disponível para remover regras.
Utilize o cmdlet New-ATPBuiltInProtectionRule para criar a regra para a política de segurança predefinida de proteção incorporada que fornece efetivamente políticas predefinidas para Ligações Seguras e Anexos Seguros no Microsoft Defender para Office 365. A regra especifica exceções à política.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Padrão)
New-ATPBuiltInProtectionRule
-SafeAttachmentPolicy <SafeAttachmentPolicyIdParameter>
-SafeLinksPolicy <SafeLinksPolicyIdParameter>
[-Comments <String>]
[-Confirm]
[-ExceptIfRecipientDomainIs <Word[]>]
[-ExceptIfSentTo <RecipientIdParameter[]>]
[-ExceptIfSentToMemberOf <RecipientIdParameter[]>]
[-Name <String>]
[-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
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-ATPBuiltInProtectionRule -SafeAttachmentPolicy "Built-In Protection Policy" -SafeLinksPolicy "Built-In Protection Policy"
Este cmdlet cria a regra para a política de segurança predefinida de proteção incorporada. Este comando falhará se a regra já existir.
Parâmetros
-Comments
Aplicável: Exchange Online
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
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 |
-ExceptIfRecipientDomainIs
Aplicável: Exchange Online
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
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
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 |
-Name
Aplicável: Exchange Online
O parâmetro Name especifica um nome exclusivo para a regra. O tamanho máximo é de 64 caracteres.
O nome da única regra é ATP Built-In Regra de Proteção.
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 |
-SafeAttachmentPolicy
Aplicável: Exchange Online
O parâmetro SafeAttachmentPolicy especifica a política Anexos Seguros que está associada à política de segurança predefinida incorporada. Utilize o seguinte comando para identificar a política: Get-SafeAttachmentPolicy | Where-Object -Property IsBuiltInProtection -eq -Value "True".
O nome da política de Anexos Seguros predefinida que é utilizada para a política de segurança predefinida de proteção incorporada é Built-In Política de Proteção.
Propriedades do parâmetro
| Tipo: | SafeAttachmentPolicyIdParameter |
| 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 |
-SafeLinksPolicy
Aplicável: Exchange Online
O parâmetro SafeLinksPolicy especifica a política ligações seguras associada à política de segurança predefinida incorporada. Utilize o seguinte comando para identificar a política: Get-SafeLinksPolicy | Where-Object -Property IsBuiltInProtection -eq -Value "True".
O nome da política de Ligações Seguras predefinida utilizada para a política de segurança predefinida de proteção incorporada é Built-In Política de Proteção.
Propriedades do parâmetro
| Tipo: | SafeLinksPolicyIdParameter |
| 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 |
-WhatIf
Aplicável: Exchange Online
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.