New-ATPBuiltInProtectionRule
Este cmdlet solo está disponible en el servicio basado en la nube.
Nota: No use este cmdlet. El sistema usa este cmdlet para crear la única regla para la directiva de seguridad preestablecida de protección integrada durante la creación de la organización. No puede usar este cmdlet si ya existe una regla para la directiva de seguridad preestablecida de protección integrada. El cmdlet Remove-ATPBuiltInProtectionRule no está disponible para quitar reglas.
Use el cmdlet New-ATPBuiltInProtectionRule para crear la regla para 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)
New-ATPBuiltInProtectionRule
-SafeAttachmentPolicy <SafeAttachmentPolicyIdParameter>
-SafeLinksPolicy <SafeLinksPolicyIdParameter>
[-Comments <String>]
[-Confirm]
[-ExceptIfRecipientDomainIs <Word[]>]
[-ExceptIfSentTo <RecipientIdParameter[]>]
[-ExceptIfSentToMemberOf <RecipientIdParameter[]>]
[-Name <String>]
[-WhatIf]
[<CommonParameters>]
Description
Para obtener más información sobre las directivas de seguridad preestablecidas en PowerShell, consulte Directivas de seguridad preestablecidas en Exchange Online PowerShell.
Importante
Los distintos tipos de excepciones de destinatario usan lógica OR (el destinatario debe satisfacer cualquiera de las excepciones especificadas). Para obtener más información, vea Perfiles en directivas de seguridad preestablecidas.
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
New-ATPBuiltInProtectionRule -SafeAttachmentPolicy "Built-In Protection Policy" -SafeLinksPolicy "Built-In Protection Policy"
Este cmdlet crea la regla para la directiva de seguridad preestablecida de protección integrada. Este comando producirá un error si la regla ya existe.
Parámetros
-Comments
Aplicable: Exchange Online
El parámetro Comments especifica comentarios informativos para la regla como, por ejemplo, la regla que se usa o la forma como ha cambiado con el tiempo. La longitud del comentario no puede superar los 1024 caracteres.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| 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 |
-Confirm
Aplicable: Exchange Online
El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. La forma en que este modificador afecta al cmdlet depende de si el cmdlet requiere confirmación antes de continuar.
- Los cmdlets destructivos (por ejemplo, los cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta:
-Confirm:$false. - La mayoría de los otros cmdlets (por ejemplo, New-* y Set-*) no tienen una pausa integrada. Para estos cmdlets, especificar el modificador Confirmar sin un valor introduce una pausa que obliga a confirmar el comando antes de continuar.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
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 |
-ExceptIfRecipientDomainIs
Aplicable: Exchange Online
El parámetro ExceptIfRecipientDomainIs especifica una excepción que busca destinatarios con direcciones de correo electrónico en los dominios especificados. Puede especificar varios dominios separados por comas.
Propiedades de parámetro
| Tipo: | Word[] |
| Valor predeterminado: | None |
| 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 |
-ExceptIfSentTo
Aplicable: Exchange Online
El parámetro ExceptIfSentTo especifica una excepción que busca destinatarios en los mensajes. Puede usar cualquier valor que identifique de forma exclusiva el destinatario. Por ejemplo:
- Nombre
- Alias
- Nombre distintivo (DN)
- Nombre distintivo (DN)
- DN canónico
- GUID
Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN".
Propiedades de parámetro
| Tipo: | RecipientIdParameter[] |
| Valor predeterminado: | None |
| 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 |
-ExceptIfSentToMemberOf
Aplicable: Exchange Online
El parámetro ExceptIfSentToMemberOf especifica una excepción que busca mensajes enviados a miembros de grupos. Puede usar cualquier valor que identifique de forma exclusiva al grupo. Por ejemplo:
- Nombre
- Alias
- Nombre distintivo (DN)
- Nombre distintivo (DN)
- DN canónico
- GUID
Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN".
PD_UCC_Multiple_Values
Propiedades de parámetro
| Tipo: | RecipientIdParameter[] |
| Valor predeterminado: | None |
| 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 |
-Name
Aplicable: Exchange Online
El parámetro Name especifica un nombre único para la regla. La longitud máxima es de 64 caracteres.
El nombre de la única regla es ATP Built-In Protection Rule.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| 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 |
-SafeAttachmentPolicy
Aplicable: Exchange Online
El parámetro SafeAttachmentPolicy especifica la directiva datos adjuntos seguros asociada a la directiva de seguridad preestablecida integrada. Use el siguiente comando para identificar la directiva: Get-SafeAttachmentPolicy | Where-Object -Property IsBuiltInProtection -eq -Value "True".
El nombre de la directiva de datos adjuntos seguros predeterminada que se usa para la directiva de seguridad preestablecida de protección integrada es Built-In directiva de protección.
Propiedades de parámetro
| Tipo: | SafeAttachmentPolicyIdParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-SafeLinksPolicy
Aplicable: Exchange Online
El parámetro SafeLinksPolicy especifica la directiva vínculos seguros asociada a la directiva de seguridad preestablecida integrada. Use el siguiente comando para identificar la directiva: Get-SafeLinksPolicy | Where-Object -Property IsBuiltInProtection -eq -Value "True".
El nombre de la directiva de vínculos seguros predeterminada que se usa para la directiva de seguridad preestablecida de protección integrada es Built-In directiva de protección.
Propiedades de parámetro
| Tipo: | SafeLinksPolicyIdParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-WhatIf
Aplicable: Exchange Online
El modificador WhatIf muestra lo que hace el comando sin realizar ningún cambio. No es necesario especificar un valor con este modificador.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | wi |
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.