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.
Sintaxis
Default (Es el valor predeterminado).
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 herramientas de informes de Microsoft o que no sean de Microsoft en Outlook (la generación de informes en Outlook está activada).
Al establecer la dirección de correo electrónico del buzón de informes en el portal de Microsoft Defender en https://security.microsoft.com/securitysettings/userSubmission, también se establece la misma dirección de correo electrónico 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 que no son de Microsoft 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 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 se le asignan. 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 -SentTo "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
Aplicable: Exchange Online
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.
Propiedades del parámetro
| Tipo: | String |
| 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 |
-Confirm
Aplicable: Exchange Online
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 el mensaje de confirmación mediante 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.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
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 |
-Enabled
Aplicable: Exchange Online
El parámetro Enabled especifica si la regla está habilitada o deshabilitada. Los valores admitidos son:
- $true: la regla está habilitada. Este valor es el 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.
Propiedades del parámetro
| Tipo: | Boolean |
| 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 |
-Name
Aplicable: Exchange Online
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.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 0 |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ReportSubmissionPolicy
Aplicable: Exchange Online
El parámetro ReportSubmissionPolicy especifica la directiva de envío de informes asociada a esta regla. La única directiva disponible se denomina DefaultReportSubmissionPolicy.
Propiedades del parámetro
| Tipo: | ReportSubmissionPolicyIdParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-SentTo
Aplicable: Exchange Online
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 los informes en Outlook están habilitados 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 que no son de Microsoft 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 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 que no son de Microsoft 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.
Propiedades del parámetro
| Tipo: | RecipientIdParameter[] |
| 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 |
-WhatIf
Aplicable: Exchange Online
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.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Wi |
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.