New-EOPProtectionPolicyRule
Este cmdlet solo está disponible en el servicio basado en la nube.
Use el cmdlet New-EOPProtectionPolicyRule para crear reglas para las características de seguridad integradas de todos los buzones de nube en directivas de seguridad preestablecidas. Las reglas especifican las condiciones y excepciones del destinatario para la protección, y también le permiten activar y desactivar las directivas de seguridad preestablecidas asociadas.
Nota: A menos que haya quitado manualmente una regla con el cmdlet de Remove-EOPProtectionPolicyRule, no se recomienda usar este cmdlet para crear reglas. Para crear la regla, debe especificar las directivas de seguridad individuales existentes asociadas a la directiva de seguridad preestablecida. Nunca recomendamos crear manualmente estas directivas de seguridad individuales necesarias. Al activar la directiva de seguridad preestablecida por primera vez en el portal de Microsoft Defender, se crean automáticamente las directivas de seguridad individuales necesarias, pero también se crean las reglas asociadas mediante este cmdlet. Por lo tanto, si las reglas ya existen, no es necesario usar este cmdlet para crearlas.
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-EOPProtectionPolicyRule
[-Name] <String>
[-Priority <Int32>]
-AntiPhishPolicy <AntiPhishPolicyIdParameter>
-HostedContentFilterPolicy <HostedContentFilterPolicyIdParameter>
-MalwareFilterPolicy <MalwareFilterPolicyIdParameter>
[-Comments <String>]
[-Confirm]
[-Enabled <Boolean>]
[-ExceptIfRecipientDomainIs <Word[]>]
[-ExceptIfSentTo <RecipientIdParameter[]>]
[-ExceptIfSentToMemberOf <RecipientIdParameter[]>]
[-RecipientDomainIs <Word[]>]
[-SentTo <RecipientIdParameter[]>]
[-SentToMemberOf <RecipientIdParameter[]>]
[-WhatIf]
[<CommonParameters>]
Description
Para obtener más información sobre las directivas de seguridad preestablecidas en PowerShell, consulte Directivas de seguridad preestablecidas en PowerShell de Exchange Online.
Importante
Los distintos tipos de condiciones de destinatario usan la lógica AND (el destinatario debe cumplir todas las condiciones especificadas). Los distintos tipos de excepciones de destinatario usan la lógica OR (el destinatario debe cumplir cualquiera de las excepciones especificadas). Para obtener más información, consulte 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 tiene asignados. 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-EOPProtectionPolicyRule -Name "Standard Preset Security Policy" -AntiPhishPolicy "Standard Preset Security Policy1622650005393" -HostedContentFilterPolicy "Standard Preset Security Policy1622650006407" -MalwareFilterPolicy "Standard Preset Security Policy1622650007658" Priority 1
Este ejemplo crea la regla para la directiva de seguridad preestablecida Standard. No se establecen restricciones sobre a quién se aplican las protecciones de Defender para Office 365. Si la regla ya existe, se producirá un error en el comando.
Parámetros
-AntiPhishPolicy
Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales
El parámetro AntiPhishPolicy especifica la directiva contra suplantación de identidad (anti-phishing) existente asociada a la directiva de seguridad preestablecida.
Si alguna vez activó la directiva de seguridad preestablecida en el portal de Microsoft Defender, el nombre de la directiva contra suplantación de identidad (anti-phishing) es uno de los siguientes valores:
- Directiva de seguridad<preestablecida Standard Número> de 13 dígitos. Por ejemplo,
Standard Preset Security Policy1622650005393. - Directiva de seguridad<preestablecida estricta Número> de 13 dígitos. Por ejemplo,
Strict Preset Security Policy1642034844713.
Puede encontrar la directiva contra suplantación de identidad (anti-phishing) que usan las directivas de seguridad preestablecidas Standard o Strict ejecutando los siguientes comandos: Get-AntiPhishPolicy | Where-Object -Property RecommendedPolicyType -eq -Value "Standard" o AntiPhishPolicy | Where-Object -Property RecommendedPolicyType -eq -Value "Strict"bien .
Propiedades de parámetro
| Tipo: | AntiPhishPolicyIdParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Comments
Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales
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 |
| Mandatory: | 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, complemento de seguridad integrado para buzones locales
El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador 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 Confirm sin un valor introduce una pausa que le obliga a reconocer 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 |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Enabled
Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales
El parámetro Enabled especifica si la regla está habilitada. Los valores admitidos son:
- $true: La regla está habilitada. El valor Estado de la regla está Habilitado. Este valor es el predeterminado.
- $false: La regla está deshabilitada. El valor de estado de la regla es Deshabilitado.
Después de crear la regla, active o desactive la directiva de seguridad preestablecida mediante uno de los siguientes comandos:
- Desactivar: Disable-EOPProtectionPolicyRule.
- Activar: Enable-EOPProtectionPolicyRule.
Propiedades de parámetro
| Tipo: | Boolean |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | 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, complemento de seguridad integrado para buzones locales
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 |
| Mandatory: | 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, complemento de seguridad integrado para buzones locales
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 |
| Mandatory: | 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, complemento de seguridad integrado para buzones locales
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 |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-HostedContentFilterPolicy
Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales
El parámetro HostedContentFilterPolicy especifica la directiva contra correo electrónico no deseado existente asociada a la directiva de seguridad predefinida.
Si alguna vez activó la directiva de seguridad preestablecida en el portal de Microsoft Defender, el nombre de la directiva contra correo electrónico no deseado es uno de los siguientes valores:
- Directiva de seguridad<preestablecida Standard Número> de 13 dígitos. Por ejemplo,
Standard Preset Security Policy1622650006407. - Directiva de seguridad<preestablecida estricta Número> de 13 dígitos. Por ejemplo,
Strict Preset Security Policy1642034847393.
Puede encontrar la directiva contra correo electrónico no deseado que usan las directivas de seguridad preestablecidas Standard o Strict ejecutando los siguientes comandos: Get-HostedContentFilterPolicy | Where-Object -Property RecommendedPolicyType -eq -Value "Standard" o Get-HostedContentFilterPolicy | Where-Object -Property RecommendedPolicyType -eq -Value "Strict".
Propiedades de parámetro
| Tipo: | HostedContentFilterPolicyIdParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-MalwareFilterPolicy
Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales
El parámetro HostedContentFilterPolicy especifica la directiva antimalware existente asociada a la directiva de seguridad preestablecida.
Si alguna vez activó la directiva de seguridad preestablecida en el portal de Microsoft Defender, el nombre de la directiva antimalware es uno de los siguientes valores:
- Directiva de seguridad<preestablecida Standard Número> de 13 dígitos. Por ejemplo,
Standard Preset Security Policy1622650007658. - Directiva de seguridad<preestablecida estricta Número> de 13 dígitos. Por ejemplo,
Strict Preset Security Policy1642034871908.
Puede encontrar la directiva antimalware que usan las directivas de seguridad preestablecidas Standard o Strict ejecutando los siguientes comandos: Get-MalwareFilterPolicy | Where-Object -Property RecommendedPolicyType -eq -Value "Standard" o Get-MalwareFilterPolicy | Where-Object -Property RecommendedPolicyType -eq -Value "Strict"bien .
Propiedades de parámetro
| Tipo: | MalwareFilterPolicyIdParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | True |
| 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, complemento de seguridad integrado para buzones locales
El parámetro Name especifica un nombre único para la regla. La longitud máxima es de 64 caracteres.
De forma predeterminada, las reglas se denominan Directiva de seguridad preestablecida Standard o Directiva de seguridad preestablecida estricta. Dado que no es necesario crear reglas distintas de las utilizadas por la directiva de seguridad preestablecida de Standard o la directiva de seguridad preestablecida estricta, se recomienda encarecidamente usar los nombres de regla predeterminados para mayor claridad y coherencia.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 0 |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Priority
Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales
El parámetro Priority especifica un valor de prioridad para la regla que determina el orden del procesamiento de la regla. Un valor entero menor indica una prioridad más alta, el valor 0 es la máxima prioridad y las reglas no pueden tener el mismo valor de prioridad.
El valor predeterminado de la regla asociada a la directiva de seguridad preestablecida estricta es 0 y el valor predeterminado de la regla asociada a la directiva de seguridad preestablecida Standard es 1.
Al crear la directiva, debe usar el valor predeterminado.
Propiedades de parámetro
| Tipo: | Int32 |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-RecipientDomainIs
Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales
El parámetro RecipientDomainIs especifica una condició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 |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-SentTo
Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales
El parámetro SentTo especifica una condició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 |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-SentToMemberOf
Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales
El parámetro SentToMemberOf especifica una condición que busca mensajes enviados a miembros de grupos de distribución, grupos de distribución dinámicos o grupos de seguridad habilitados para correo. 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 |
| Mandatory: | False |
| 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, complemento de seguridad integrado para buzones locales
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 |
| Mandatory: | 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.