Get-ATPBuiltInProtectionRule
Esse cmdlet só está disponível no serviço baseado em nuvem.
Utilize o cmdlet Get-ATPBuiltInProtectionRule para ver a regra da 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 (Default)
Get-ATPBuiltInProtectionRule
[[-Identity] <DehydrateableRuleIdParameter>]
[-State <RuleState>]
[<CommonParameters>]
Description
Para obter mais informações sobre políticas de segurança predefinidas, veja Preset security policies in cloud organizations (Políticas de segurança predefinidas em organizações na cloud).
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
Get-ATPBuiltInProtectionRule
Este exemplo mostra a regra para a política de segurança predefinida de proteção incorporada.
Parâmetros
-Identity
Aplicável: Exchange Online
O parâmetro Identidade especifica a regra que pretende ver. É possível usar qualquer valor que identifique a regra com exclusividade. Por exemplo:
- Nome
- DN (nome diferenciado)
- GUID
O nome da única regra é ATP Built-In Regra de Proteção.
Atenção: o valor $null ou um valor inexistente para o parâmetro Identidade devolve todos os objetos como se tivesse executado o comando Get- sem o parâmetro Identity. Verifique se as listas de valores do parâmetro Identity estão corretas e não contêm valores de $null inexistentes.
Propriedades do parâmetro
| Tipo: | DehydrateableRuleIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-State
Aplicável: Exchange Online
O parâmetro State filtra os resultados de acordo com o estado da regra. Os valores válidos são:
- Desabilitado
- Habilitado
A única regra está sempre ativada.
Propriedades do parâmetro
| Tipo: | RuleState |
| Valor padrão: | None |
| Valores aceitos: | Enabled, Disabled |
| 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 |
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.