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 |