Partilhar via

Get-ATPProtectionPolicyRule

  • Referência
Módulo:
ExchangePowerShell
Aplica-se a:
Exchange Online

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

Use o cmdlet Get-ATPProtectionPolicyRule para exibir regras para proteções de Microsoft Defender para Office 365 em políticas de segurança predefinidas. As regras especificam condições de destinatário e exceções para a proteção e também permitem ativar e desativar as políticas de segurança predefinidas associadas.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

Get-ATPProtectionPolicyRule
   [[-Identity] <RuleIdParameter>]
   [-State <RuleState>]
   [<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.

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

Get-ATPProtectionPolicyRule | Format-Table Name,State

Este exemplo retorna uma lista de resumo das regras para proteções de Defender para Office 365 em políticas de segurança predefinidas.

Exemplo 2

Get-ATPProtectionPolicyRule -Identity "Strict Preset Security Policy"

Este exemplo retorna informações detalhadas sobre a regra chamada Strict Preset Security Policy.

Parâmetros

-Identity

O parâmetro Identity especifica a regra que você deseja exibir. É possível usar qualquer valor que identifique a regra com exclusividade. Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • GUID

Por padrão, as regras disponíveis (se existirem) são nomeadas Política de Segurança Predefinida Padrão e Política de Segurança Predefinida Estrita.

Type:RuleIdParameter
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online

-State

O parâmetro State filtra os resultados de acordo com o estado da regra. Os valores válidos são:

  • Habilitado
  • Desabilitado
Type:RuleState
Accepted values:Enabled, Disabled
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online