Set-MailboxJunkEmailConfiguration
Este cmdlet está disponible en Exchange local y en el servicio basado en la nube. Puede que algunos parámetros y opciones de configuración sean exclusivos de un entorno u otro.
Use el cmdlet Set-MailboxJunkEmailConfiguration para configurar los valores de correo no deseado en los buzones.
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
Set-MailboxJunkEmailConfiguration
[-Identity] <MailboxIdParameter>
[-BlockedSendersAndDomains <MultiValuedProperty>]
[-Confirm]
[-ContactsTrusted <Boolean>]
[-DomainController <Fqdn>]
[-Enabled <Boolean>]
[-IgnoreDefaultScope]
[-TrustedListsOnly <Boolean>]
[-TrustedRecipientsAndDomains <MultiValuedProperty>]
[-TrustedSendersAndDomains <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>]
Description
Este cmdlet controla la siguiente configuración de correo no deseado en el buzón:
Habilitar o deshabilitar la regla de correo electrónico no deseado: en Exchange local, la regla de correo electrónico no deseado (una regla de bandeja de entrada oculta denominada Regla de correo no deseado) controla la entrega de mensajes a la carpeta Email de correo no deseado o a la Bandeja de entrada según el umbral de carpeta de Email correo no deseado de SCL (para la organización o el buzón) y la colección de listas seguras en el buzón.
En el servicio basado en la nube, la regla de correo no deseado no tiene ningún efecto en el flujo de correo. Exchange Online Protection entrega mensajes a la carpeta junk Email en función de las acciones establecidas en las directivas contra correo no deseado. La regla de correo electrónico no deseado del buzón sigue controla lo que sucede con los mensajes después de la entrega en función de la colección de listas seguras del buzón.
Los usuarios pueden habilitar o deshabilitar la regla de correo no deseado en su propio buzón mediante Outlook en la Web.
Configurar la colección de listas seguras: la colección safelist es la lista Remitentes seguros, la lista Destinatarios seguros y la lista Remitentes bloqueados. Los usuarios pueden configurar la colección de listas seguras en su propio buzón de correo mediante Microsoft Outlook o Outlook en la Web.
Para obtener más información, vea Configurar opciones de antispam de Exchange en buzones de correo.
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
Set-MailboxJunkEmailConfiguration "David Pelton" -Enabled $false
En este ejemplo se deshabilita la regla de correo electrónico no deseado para el usuario llamado David Pelton. En Exchange local, los mensajes ya no se mueven entre la bandeja de entrada y la carpeta de Email no deseado según el umbral de carpeta Email de correo no deseado de SCL (organización o buzón) o la colección de listas seguras del buzón. En Exchange Online, la colección safelist del buzón no puede mover mensajes entre la bandeja de entrada y la carpeta de Email no deseado. Los mensajes se siguen entregando en la carpeta Email de correo no deseado en función del veredicto y de la acción correspondiente de las directivas contra correo no deseado.
Ejemplo 2
Set-MailboxJunkEmailConfiguration "Michele Martin" -TrustedSendersAndDomains @{Add="contoso.com","fabrikam.com"} -BlockedSendersAndDomains @{Add="jane@fourthcoffee.com"}
En este ejemplo se hacen los siguientes cambios de configuración en la colección safelist para el usuario llamado Michele Martin:
- Agrega contoso.com y fabrikam.com a la lista Remitentes seguros sin afectar a otras entradas existentes.
- Se agrega jane@fourthcoffee.com a la lista Remitentes bloqueados sin que afecte a otras entradas existentes.
Ejemplo 3
Get-MailboxJunkEmailConfiguration * | Where {$_.ContactsTrusted -eq $true} | Set-MailboxJunkEmailConfiguration -ContactsTrusted $false
En este ejemplo se identifican los buzones en los que los contactos se tratan como remitentes de confianza y, a continuación, cambia la configuración del correo no deseado para no tratar a los contactos como remitentes de confianza.
Parámetros
-BlockedSendersAndDomains
El parámetro BlockedSendersAndDomains especifica la lista Remitentes bloqueados, que es una lista de direcciones de correo electrónico del remitente y dominios cuyos mensajes se envían automáticamente a la carpeta Email no deseado. Este parámetro corresponde a la configuración de Outlook en la Web: Mover correo electrónico de estos remitentes o dominios a mi carpeta de Email no deseado.
Para especificar varios valores y sobrescribir las entradas existentes, use la siguiente sintaxis: Value1,Value2,...ValueN
. Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN"
.
Para agregar o quitar uno o más valores sin afectar las entradas existentes, use la siguiente sintaxis: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-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, 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 demás cmdlets (por ejemplo, los cmdlets 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-ContactsTrusted
El parámetro ContactsTrusted especifica si los contactos de la carpeta Contactos se consideran como remitentes de confianza. Este parámetro corresponde a la configuración de Outlook en la Web: Confiar en el correo electrónico de mis contactos. Los valores admitidos son:
- $true: los mensajes de los contactos de la carpeta Contactos que llegan al buzón nunca se entregan a la carpeta de Email de correo no deseado, independientemente del contenido.
- $false: Los mensajes de los contactos de la carpeta Contactos no se tratan como remitentes de confianza. La dirección de correo electrónico es un remitente de confianza solo si se define en la lista Remitentes seguros. Este es el valor predeterminado.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DomainController
Este parámetro solo está disponible en Exchange local.
El parámetro DomainController especifica el controlador de dominio que el cmdlet usa para leer datos de Active Directory o escribirlos. El controlador de dominio se identifica por su nombre de dominio completo (FQDN). Por ejemplo, dc01.contoso.com.
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Enabled
El parámetro Enabled habilita o deshabilita la regla de correo no deseado en el buzón (una regla de bandeja de entrada oculta denominada Regla de correo no deseado). Los valores admitidos son:
$true: la regla de correo no deseado está habilitada en el buzón. Este valor equivale a la opción de configuración de Outlook en la web Filtrar automáticamente el correo electrónico no deseado. Este es el valor predeterminado.
En Exchange local, la colección de listas seguras del buzón (la lista De remitentes seguros, la lista Destinatarios seguros y la lista Remitentes bloqueados) y el umbral de carpeta de Email de correo no deseado de SCL (para la organización o el buzón) entrega mensajes a la bandeja de entrada o a la carpeta de Email no deseado.
En el servicio basado en la nube, la colección safelist del buzón mueve los mensajes entregados entre la bandeja de entrada o la carpeta de Email no deseado. Los mensajes se entregan a la carpeta de Email no deseado según el veredicto y la acción correspondiente de las directivas antispam únicamente.
$false: la regla de correo no deseado está deshabilitada en el buzón. Este valor equivale a la opción de configuración de Outlook en la web No mover correo electrónico a mi carpeta de correo no deseado.
En Exchange local, la colección safelist del buzón o el umbral de carpeta de Email de correo no deseado de SCL no pueden entregar mensajes a la bandeja de entrada o a la carpeta de Email no deseado.
En el servicio basado en la nube, la colección safelist del buzón no puede mover los mensajes entregados entre la bandeja de entrada o la carpeta de Email no deseado. Los mensajes se siguen entregando en la carpeta Email de correo no deseado en función del veredicto y de la acción correspondiente de las directivas contra correo no deseado.
Para ver el estado de la regla de correo no deseado, ejecute cualquiera de los siguientes comandos para buscar el valor de la propiedad Enabled:
Get-MailboxJunkEmailConfiguration -Identity <MailboxIdentity>
- Solo Exchange local:
Get-InboxRule "Junk E-mail Rule" -Mailbox <MailboxIdentity> -IncludeHidden
El estado de la regla de correo no deseado en el buzón no afecta a la configuración de correo no deseado del lado cliente que están disponibles en el filtro de Email no deseado de Outlook. Incluso cuando la regla de correo no deseado está deshabilitada en el buzón, Outlook puede mover los mensajes a la carpeta de Email no deseado. Por ejemplo, si Outlook determina que el mensaje es correo no deseado o el remitente se define en la lista Remitentes bloqueados, Outlook puede mover el mensaje a la carpeta Email no deseado. Para obtener más información, vea Información general sobre el filtro de Email no deseado.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Identity
El parámetro Identity especifica el buzón que desea modificar. Es posible usar cualquier valor que identifique exclusivamente el buzón. Por ejemplo:
- Nombre
- Alias
- Nombre distintivo (DN)
- Nombre completo (DN)
- Dominio\Nombre de usuario
- Dirección de correo electrónico
- GUID
- LegacyExchangeDN
- SamAccountName
- ID de usuario o nombre de la entidad de seguridad de usuario (UPN)
Type: | MailboxIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-IgnoreDefaultScope
El modificador IgnoreDefaultScope indica al comando que ignore la configuración predeterminada del ámbito del destinatario para la sesión de Exchange PowerShell y que use todo el bosque como ámbito. No es necesario especificar un valor con este modificador.
Este cambio habilita el comando tenga acceso a objetos de Active Directory que no están actualmente disponibles en el ámbito predeterminado, pero también introduce las siguientes restricciones:
- No puede usar el parámetro DomainController. El comando usa un servidor de catálogo global adecuado de forma automática.
- Sólo puede usar el DN para el parámetro Identity. No se aceptan otras formas de identificación, como alias o GUID.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-TrustedListsOnly
El parámetro TrustedListsOnly especifica que solo los mensajes de los remitentes de la lista Remitentes seguros se entregan a la Bandeja de entrada. Todos los demás mensajes se tratan como correo electrónico no deseado. Este parámetro corresponde a la configuración de Outlook en la Web: no confíe en el correo electrónico a menos que provenga de alguien de mi lista De remitentes y destinatarios seguros. Los valores admitidos son:
- $true: solo los mensajes de la dirección de correo electrónico o las entradas de dominio de la lista Remitentes seguros y la lista Destinatarios seguros se entregan en la Bandeja de entrada. Todos los demás mensajes se entregan automáticamente a la carpeta de Email no deseado.
- $false: los mensajes de otros remitentes, destinatarios y dominios no se tratan automáticamente como correo no deseado y se evalúan individualmente. Este es el valor predeterminado.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-TrustedRecipientsAndDomains
Este parámetro está reservado para uso interno de Microsoft.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-TrustedSendersAndDomains
El parámetro TrustedSendersAndDomains especifica la lista Remitentes seguros y la lista Destinatarios seguros, que son listas de direcciones de correo electrónico y dominios. Los mensajes de estos remitentes que llegan al buzón nunca se entregan a la carpeta de correo no deseado Email, independientemente del contenido. Este parámetro corresponde a la configuración de Outlook en la Web: no mueva el correo electrónico de estos remitentes o dominios a mi carpeta de Email no deseado.
Para especificar varios valores y sobrescribir las entradas existentes, use la siguiente sintaxis: Value1,Value2,...ValueN
. Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN"
.
Para agregar o quitar uno o más valores sin afectar las entradas existentes, use la siguiente sintaxis: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
.
Para vaciar la lista de direcciones de correo electrónico y dominios, use el valor $null.
Notas:
- No puede agregar direcciones de correo electrónico del remitente desde el mismo dominio que la dirección de correo electrónico del destinatario. Todos los buzones de la lista global de direcciones (GAL) se consideran automáticamente remitentes de confianza.
- No puede modificar directamente la lista destinatarios seguros mediante este cmdlet. Use este parámetro para modificar la lista Remitentes seguros y las direcciones de correo electrónico y los dominios se sincronizan con la lista Destinatarios seguros.
- En EOP independiente con sincronización de directorios, las entradas de dominio no se sincronizan de forma predeterminada, pero puede habilitar la sincronización para dominios. Para obtener más información, consulte Configurar el filtrado de contenido para usar datos de dominio seguro.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
Entradas
Input types
Para ver los tipos de entrada que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de entrada de un cmdlet está en blanco, el cmdlet no acepta datos de entrada.
Salidas
Output types
Para ver los tipos de valor devuelto (también conocidos como tipos de resultado) que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de resultado está en blanco, el cmdlet no devuelve datos.