Get-MailboxJunkEmailConfiguration

Este cmdlet está disponible en Exchange local y en el servicio basado en la nube. Algunos parámetros y configuraciones pueden ser exclusivos de un entorno u otro.

Use el cmdlet Get-MailboxJunkEmailConfiguration para ver la configuración 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.

Sintaxis

Default (valor predeterminado)

Get-MailboxJunkEmailConfiguration
    [-Identity] <MailboxIdParameter>
    [-Credential <PSCredential>]
    [-DomainController <Fqdn>]
    [-ReadFromDomainController]
    [-ResultSize <Unlimited>]
    [<CommonParameters>]

Description

La configuración de correo no deseado en el buzón es:

  • Habilitar o deshabilitar la regla de correo no deseado: en Exchange local, la regla de correo no deseado (una regla oculta de la bandeja de entrada denominada regla de correo electrónico no deseado) controla la entrega de mensajes a la carpeta Email no deseado o a la bandeja de entrada en función del umbral de la carpeta de Email de correo no deseado SCL (para la organización o el buzón) y la colección de listas seguras del 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. Los mensajes se entregan en la carpeta Correo no deseado Email en función de las acciones establecidas en las directivas contra correo electrónico no deseado. La regla de correo no deseado en el buzón sigue controlando lo que sucede con los mensajes después de la entrega en función de la recopilación de la lista segura del buzón.

    Los usuarios pueden habilitar o deshabilitar la regla de correo no deseado en su propio buzón de correo mediante Outlook en la Web.

  • Configure la colección de la lista segura: La colección de la lista segura es la lista de remitentes seguros, la lista de destinatarios seguros y la lista de remitentes bloqueados. Los usuarios pueden configurar la colección de lista segura en su propio buzón mediante Microsoft Outlook o Outlook en la Web.

Los administradores pueden habilitar o deshabilitar la regla de correo no deseado y configurar la colección de lista segura en un buzón mediante el Set-MailboxJunkEmailConfiguration cmdlet. Para obtener más información, consulte Configurar las opciones de protección contra correo electrónico no deseado de Exchange en buzones.

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

Get-MailboxJunkEmailConfiguration -Identity "David Pelton"

En este ejemplo se devuelve la configuración de correo no deseado para el usuario llamado David Pelton.

Ejemplo 2

$AllUsers = Get-Mailbox -ResultSize unlimited -RecipientTypeDetails UserMailbox

$AllUsers | foreach {Get-MailboxJunkEmailConfiguration -Identity $_.UserPrincipalName} | Where {$_.Enabled -eq $false} | Format-Table -Auto Identity,Enabled

En este ejemplo se devuelve una lista resumida de todos los buzones de correo electrónico no deseado de la organización donde la regla de correo no deseado está deshabilitada. El primer comando almacena todos los buzones de usuario en una variable. El segundo comando analiza los buzones y devuelve el FQDN de los buzones en los que está deshabilitada la regla de correo no deseado.

Para devolver todos los buzones en los que la regla de correo no deseado está habilitada, cambie el valor $false a $true. Para devolver una lista mixta de buzones donde la regla de correo no deseado está habilitada y deshabilitada, quite la casilla "| where {$_. Habilitado -eq $false " parte del segundo comando.

Parámetros

-Credential

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

El parámetro Credential especifica el nombre de usuario y la contraseña que se usan para ejecutar este comando. Por lo general, este parámetro se usa en scripts o cuando deben proporcionarse credenciales diferentes que disponen de los permisos necesarios.

Un valor para este parámetro requiere el cmdlet Get-Credential. Para pausar este comando y recibir una solicitud de credenciales, use el valor (Get-Credential). O bien, antes de ejecutar este comando, almacene las credenciales en una variable (por ejemplo, $cred = Get-Credential) y, a continuación, use el nombre de variable ($cred) para este parámetro. Para más información, vea Get-Credential.

Propiedades de parámetro

Tipo:PSCredential
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

-DomainController

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.

Propiedades de parámetro

Tipo:Fqdn
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

-Identity

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

El parámetro Identity especifica el buzón que desea ver. 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)

Puede usar el carácter comodín (*) para identificar varios buzones.

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 para el parámetro Identidad sean precisas y no contengan valores $null inexistentes.

Propiedades de parámetro

Tipo:MailboxIdParameter
Valor predeterminado:None
Admite caracteres comodín:True
DontShow:False

Conjuntos de parámetros

(All)
Posición:1
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ReadFromDomainController

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

El conmutador ReadFromDomainController especifica que la información se debe leer de un controlador de dominio en el dominio del usuario. No es necesario especificar un valor con este modificador.

El comando: Set-AdServerSettings -ViewEntireForest $true para incluir todos los objetos del bosque requiere el modificador ReadFromDomainController. De lo contrario, el comando podría utilizar un catálogo global que contenga información obsoleta. Además, es posible que tenga que ejecutar varias iteraciones del comando con el modificador ReadFromDomainController para obtener la información.

De forma predeterminada, el ámbito de destinatarios se establece en el dominio que hospeda los servidores de Exchange.

Propiedades de parámetro

Tipo:SwitchParameter
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

-ResultSize

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

El parámetro ResultSize especifica el número máximo de resultados que se van a devolver. Si desea incluir en los resultados devueltos todas las solicitudes que coincidan con la consulta, use el valor ilimitado para este parámetro. El valor predeterminado es 1000.

Propiedades de parámetro

Tipo:Unlimited
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

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.

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.