New-HostedOutboundSpamFilterRule

Este cmdlet solo está disponible en el servicio basado en la nube.

Use el cmdlet New-HostedOutboundSpamFilterRule para crear reglas de filtro de correo no deseado salientes en su organización basada en la nube.

Nota: Se recomienda que use el módulo de Exchange Online PowerShell V2 para conectarse a Exchange Online PowerShell. Para obtener instrucciones, consulte Conexión a Exchange Online PowerShell.

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.

Syntax

New-HostedOutboundSpamFilterRule
   [-Name] <String>
   -HostedOutboundSpamFilterPolicy <HostedOutboundSpamFilterPolicyIdParameter>
   [-Comments <String>]
   [-Confirm]
   [-Enabled <Boolean>]
   [-ExceptIfFrom <RecipientIdParameter[]>]
   [-ExceptIfFromMemberOf <RecipientIdParameter[]>]
   [-ExceptIfSenderDomainIs <Word[]>]
   [-From <RecipientIdParameter[]>]
   [-FromMemberOf <RecipientIdParameter[]>]
   [-Priority <Int32>]
   [-SenderDomainIs <Word[]>]
   [-WhatIf]
   [<CommonParameters>]

Description

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. 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-HostedOutboundSpamFilterRule -Name "Contoso Executives" -HostedOutboundSpamFilterPolicy "Contoso Executives" -FromMemberOf Executives

En este ejemplo se crea una nueva regla de filtro de correo no deseado saliente denominada ejecutivos de Contoso que está asociada con el nombre de la Directiva de filtro de correo no deseado saliente ejecutivos de Contoso que se aplica a los miembros del grupo ejecutivos.

Parámetros

-Comentarios

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.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-Confirm

El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador el 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 la solicitud de confirmación con esta sintaxis exacta: -Confirm:$false .
  • La mayoría de los otros cmdlets (por ejemplo, New-* y Set-*) no tienen una pausa integrada. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar el comando antes de continuar.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-Desde

El parámetro from especifica una condición que busca mensajes de remitentes específicos. Puede usar cualquier valor que identifique de forma exclusiva al remitente. Por ejemplo:

  • Nombre
  • Alias
  • Nombre distintivo (DN)
  • Nombre distintivo (DN)
  • DN canónico
  • GUID

Update Si los valores contienen espacios o requieren comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN" .

Type:RecipientIdParameter[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-ExceptIfFrom

El parámetro ExceptIfFrom especifica una excepción que busca mensajes de remitentes específicos. Puede usar cualquier valor que identifique de forma exclusiva al remitente. Por ejemplo:

  • Nombre
  • Alias
  • Nombre distintivo (DN)
  • Nombre distintivo (DN)
  • DN canónico
  • GUID

Update Si los valores contienen espacios o requieren comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN" .

Type:RecipientIdParameter[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-ExceptIfFromMemberOf

El parámetro ExceptIfFromMemberOf especifica una excepción que busca los mensajes enviados por los miembros del grupo. 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 requieren comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN" .

Type:RecipientIdParameter[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-ExceptIfSenderDomainIs

El parámetro ExceptIfSenderDomainIs especifica una excepción que busca remitentes con dirección de correo electrónico en los dominios especificados. Puede especificar varios dominios separados por comas.

Type:Word[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-FromMemberOf

El parámetro FromMemberOf especifica una condición que busca los mensajes enviados por los miembros del grupo. 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 requieren comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN" .

Type:RecipientIdParameter[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-Habilitado para

El parámetro Enabled especifica si la regla está habilitada. Los valores válidos son:

  • $true: la regla está habilitada. Este es el valor predeterminado.
  • $false: la regla está deshabilitada.

En las propiedades de la regla, el valor de este parámetro es visible en la propiedad State.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-HostedOutboundSpamFilterPolicy

El parámetro HostedOutboundSpamFilterPolicy especifica la Directiva de filtro de correo no deseado saliente que está asociada a la regla de filtro de correo no deseado saliente.

Puede obtener este valor mediante la ejecución del comando Get-ComplianceSearch | Format-Table -Auto Name,JobRunId,Status

  • Nombre
  • Nombre completo (DN)
  • GUID@.

No se puede especificar la Directiva de filtro de correo no deseado saliente predeterminada y no se puede especificar una directiva que ya esté asociada a otra regla de filtro de correo no deseado saliente.

Type:HostedOutboundSpamFilterPolicyIdParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-Name

El parámetro name especifica un nombre único para la regla de filtro de correo no deseado saliente. La longitud máxima es de 64 caracteres. Si el valor contiene espacios, escríbalo entre comillas (").

No use los siguientes caracteres: \ % & * + / = ? { } | < > ( ) ; : [ ] , ".

Type:String
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-Priority

El parámetro Priority especifica un valor de prioridad para la regla que determina el orden de procesamiento de la regla. Un valor entero inferior indica una prioridad más alta, el valor 0 es la prioridad más alta y las reglas no pueden tener el mismo valor de prioridad.

El parámetro Priority especifica un valor de prioridad para la regla que determina el orden de 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.

  • Los valores válidos y el valor predeterminado para este parámetro dependen del número de reglas existentes. Por ejemplo, si hay 8 reglas:
  • Los valores de prioridad válidos para las 8 reglas van de 0 a 7.
  • Los valores de prioridad válidos para una regla nueva (la 9.º) van de 0 a 8.

El valor predeterminado para una nueva regla (la regla 9.ª) es 8.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-SenderDomainIs

El parámetro SenderDomainIs especifica una condición que busca los remitentes con dirección de correo electrónico en los dominios especificados. Puede especificar varios dominios separados por comas.

Type:Word[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-WhatIf

El modificador WhatIf simula las acciones del comando. Puede usar este modificador para ver los cambios que se producirían, pero sin aplicar los cambios. No es necesario especificar un valor con este modificador.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

Entradas

Salidas