Get-ATPBuiltInProtectionRule
Este cmdlet solo está disponible en el servicio basado en la nube.
Use el cmdlet Get-ATPBuiltInProtectionRule para ver la regla de la directiva de seguridad preestablecida de protección integrada que proporciona de forma eficaz directivas predeterminadas para vínculos seguros y datos adjuntos seguros en Microsoft Defender para Office 365. La regla especifica excepciones a la directiva.
Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.
Sintaxis
Default (valor predeterminado)
Get-ATPBuiltInProtectionRule
[[-Identity] <DehydrateableRuleIdParameter>]
[-State <RuleState>]
[<CommonParameters>]
Description
Para obtener más información sobre las directivas de seguridad preestablecidas, consulte Directivas de seguridad preestablecidas en organizaciones en la nube.
Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este artículo se enumeran todos los parámetros del cmdlet, es posible que no tenga acceso a algunos parámetros si no se incluyen en los permisos que se le asignan. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.
Ejemplos
Ejemplo 1
Get-ATPBuiltInProtectionRule
En este ejemplo se muestra la regla de la directiva de seguridad preestablecida de protección integrada.
Parámetros
-Identity
Aplicable: Exchange Online
El parámetro Identity especifica la regla que desea ver. Puede usar cualquier valor que identifique de forma exclusiva la regla. Por ejemplo:
- Nombre
- Nombre completo (DN)
- GUID
El nombre de la única regla es ATP Built-In Protection Rule.
Precaución: El valor $null o un valor inexistente para el parámetro Identity devuelve todos los objetos como si ejecutara el comando Get- sin el parámetro Identity. Compruebe que las listas de valores del parámetro Identity son precisas y no contienen valores $null inexistentes.
Propiedades de parámetro
| Tipo: | DehydrateableRuleIdParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 0 |
| Obligatorio: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-State
Aplicable: Exchange Online
El parámetro State filtra los resultados por el estado de la regla. Los valores admitidos son:
- Deshabilitado
- Habilitado
La única regla siempre está habilitada.
Propiedades de parámetro
| Tipo: | RuleState |
| Valor predeterminado: | None |
| Valores aceptados: | Enabled, Disabled |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.