New-ReportSubmissionRule

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

Use el cmdlet New-ReportSubmissionRule para crear la regla de envío de informes en la organización basada en la nube. La regla de envío de informes identifica el buzón de informes donde se entregan los mensajes notificados por el usuario.

Nota: Si la regla ya existe (el cmdlet Get-ReportSubmissionRule devuelve la salida), no puede usar este cmdlet. Para eliminar la regla existente y empezar de nuevo, use primero el cmdlet Remove-ReportSubmissionRule.

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-ReportSubmissionRule
   [-Name] <String>
   -ReportSubmissionPolicy <ReportSubmissionPolicyIdParameter>
   [-Comments <String>]
   [-Confirm]
   [-Enabled <Boolean>]
   [-SentTo <RecipientIdParameter[]>]
   [-WhatIf]
   [<CommonParameters>]

Description

Solo puede usar este cmdlet si se cumplen las siguientes instrucciones:

  • La regla de envío de informes no existe (el cmdlet Get-ReportSubmissionRule no devuelve ninguna salida).
  • Existe la directiva de envío de informes (el cmdlet Get-ReportSubmissionPolicy devuelve la salida).

El parámetro SentTo identifica la dirección de correo electrónico del buzón de informes. Su organización necesita una regla de envío de informes solo para enviar mensajes notificados por el usuario al buzón de informes mediante Microsoft o herramientas de informes de terceros en Outlook (la experiencia de informes integrada de Microsoft está activada).

Al establecer la dirección de correo electrónico del buzón de informes en el portal de Microsoft 365 Defender en https://security.microsoft.com/securitysettings/userSubmission, la misma dirección de correo electrónico también se establece en los cmdlets *-ReportSubmissionPolicy:

  • Informes integrados de Microsoft mediante herramientas de informes de Microsoft en Outlook: ReportJunkAddresses, ReportNotJunkAddresses y ReportPhishAddresses (los tres deben ser el mismo valor).
  • Informes integrados de Microsoft mediante herramientas de informes de terceros en Outlook: ThirdPartyReportAddresses.

Cuando se usa este cmdlet para establecer la dirección de correo electrónico del buzón de informes, los parámetros correspondientes de los cmdlets *-ReportSubmissionPolicy no se actualizan.

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-ReportSubmissionRule -Name DefaultReportSubmissionRule -ReportSubmissionPolicy DefaultReportSubmissionPolicy -SendTo "userreportedmessages@contoso.onmicrosoft.com"

En este ejemplo se crea la regla de envío de informes. El buzón de informes es userreportedmessages@contoso.onmicrosoft.com.

Parámetros

-Comments

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
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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 Online

-Enabled

El parámetro Enabled especifica si la regla está habilitada o deshabilitada. Los valores admitidos son:

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

Después de crear la regla, use los cmdlets Enable-ReportSubmissionRule y Disable-ReportSubmissionRule para habilitar o deshabilitar la regla.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Name

El parámetro Name especifica el nombre de la regla de envío de informes. Cuando la regla se crea automáticamente, el nombre de la regla es DefaultReportSubmissionRule. Se recomienda usar este valor para evitar confusiones.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ReportSubmissionPolicy

El parámetro ReportSubmissionPolicy especifica la directiva de envío de informes asociada a esta regla. La única directiva disponible se denomina DefaultReportSubmissionPolicy.

Type:ReportSubmissionPolicyIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-SentTo

El parámetro SentTo especifica la dirección de correo electrónico del buzón de informes en Exchange Online donde se envían los mensajes notificados por el usuario.

El valor de este parámetro solo es significativo si la experiencia de informes integrada de Microsoft está habilitada y los mensajes notificados por el usuario se envían a un buzón de informes tal como se configura en los cmdlets *-ReportSubmissionPolicy (cualquiera de los escenarios siguientes):

  • Los informes integrados de Microsoft están habilitados mediante las herramientas de informes de Microsoft en Outlook: -EnableThirdPartyAddress $false -ReportJunkToCustomizedAddress $true -ReportNotJunkToCustomizedAddress $true -ReportPhishToCustomizedAddress $true.
  • Los informes integrados de Microsoft están habilitados mediante herramientas de informes de terceros en Outlook: -EnableReportToMicrosoft $false -EnableThirdPartyAddress $true -ReportJunkToCustomizedAddress $false -ReportNotJunkToCustomizedAddress $false -ReportPhishToCustomizedAddress $false.

Si establece la dirección de correo electrónico del buzón de informes en el portal de Microsoft 365 Defender, los parámetros siguientes de los cmdlets *-ReportSubmissionPolicy se establecen en el mismo valor:

  • Informes integrados de Microsoft mediante herramientas de informes de Microsoft en Outlook: ReportJunkAddresses, ReportNotJunkAddresses y ReportPhishAddresses (los tres deben ser el mismo valor).
  • Informes integrados de Microsoft mediante herramientas de informes de terceros en Outlook: ThirdPartyReportAddresses.

Cuando se usa este cmdlet para establecer la dirección de correo electrónico del buzón de informes, los valores de parámetro relacionados en los cmdlets *-ReportSubmissionPolicy no se actualizan, lo que no afecta a la funcionalidad del buzón de informes. Debe actualizar los valores relacionados en los cmdlets *-ReportSubmissionPolicy para que sean coherentes y para evitar confusiones.

Type:RecipientIdParameter[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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 Online