New-ATPBuiltInProtectionRule
Esse cmdlet só está disponível no serviço baseado em nuvem.
Observação: não use este cmdlet. Esse cmdlet é usado pelo sistema para criar a única regra para a política de segurança predefinida de proteção interna durante a criação da organização. Você não poderá usar esse cmdlet se uma regra para a política de segurança predefinida de proteção interna já existir. O cmdlet Remove-ATPBuiltInProtectionRule não está disponível para remover regras.
Use o cmdlet New-ATPBuiltInProtectionRule para criar a regra para a política de segurança predefinida de proteção interna que fornece efetivamente políticas padrão para Links Seguros e Anexos Seguros em 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.
Syntax
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 políticas de segurança predefinidas no PowerShell, consulte Políticas de segurança predefinidas no Exchange Online PowerShell.
Importante
Tipos diferentes de condições de destinatário ou diferentes tipos de exceções de destinatário não são aditivos; elas são inclusivas. Para obter mais informações, consulte Perfis em políticas de segurança predefinidas.
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
New-ATPBuiltInProtectionRule -SafeAttachmentPolicy "Built-In Protection Policy" -SafeLinksPolicy "Built-In Protection Policy"
Esse cmdlet cria a regra para a política de segurança predefinida de proteção interna. Esse comando falhará se a regra já existir.
Parâmetros
-Comments
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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-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 esses cmdlets, você pode ignorar a solicitação 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 Online |
-ExceptIfRecipientDomainIs
O parâmetro ExceptIfRecipientDomainIs especifica uma exceção que procura destinatários com endereços de email nos domínios especificados. É possível especificar vários domínios, separando-os por vírgulas.
Type: | Word[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-ExceptIfSentTo
O parâmetro ExceptIfSentTo especifica uma exceçã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"
.
Type: | RecipientIdParameter[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-ExceptIfSentToMemberOf
O parâmetro ExceptIfSentToMemberOf especifica uma exceção que procura mensagens enviadas a 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
Type: | RecipientIdParameter[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-Name
O parâmetro Name especifica um nome exclusivo para a regra. O tamanho máximo é de 64 caracteres.
O nome da única regra é A regra de proteção de Built-In ATP.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-SafeAttachmentPolicy
O parâmetro SafeAttachmentPolicy especifica a política Anexos Seguros associada à política de segurança predefinida interna. Use o seguinte comando para identificar a política: Get-SafeAttachmentPolicy | Where-Object -Property IsBuiltInProtection -eq -Value "True"
.
O nome da política padrão de Anexos Seguros que é usada para a política de segurança predefinida de proteção interna é Built-In Política de Proteção.
Type: | SafeAttachmentPolicyIdParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-SafeLinksPolicy
O parâmetro SafeLinksPolicy especifica a política de Links Seguros associada à política de segurança predefinida interna. Use o seguinte comando para identificar a política: Get-SafeLinksPolicy | Where-Object -Property IsBuiltInProtection -eq -Value "True"
.
O nome da política padrão de Links Seguros usada para a política de segurança predefinida de proteção interna é Built-In Política de Proteção.
Type: | SafeLinksPolicyIdParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-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 Online |