New-ReportSubmissionRule

Questo cmdlet è disponibile solamente nel servizio basato sul cloud.

Usare il cmdlet New-ReportSubmissionRule per creare la regola di invio del report nell'organizzazione basata sul cloud. La regola di invio del report identifica la cassetta postale di report in cui vengono recapitati i messaggi segnalati dall'utente.

Nota: se la regola esiste già (il cmdlet Get-ReportSubmissionRule restituisce l'output), non è possibile usare questo cmdlet. Per eliminare la regola esistente e ricominciare da capo, usare prima il cmdlet Remove-ReportSubmissionRule.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

New-ReportSubmissionRule
   [-Name] <String>
   -ReportSubmissionPolicy <ReportSubmissionPolicyIdParameter>
   [-Comments <String>]
   [-Confirm]
   [-Enabled <Boolean>]
   [-SentTo <RecipientIdParameter[]>]
   [-WhatIf]
   [<CommonParameters>]

Descrizione

È possibile usare questo cmdlet solo se le istruzioni seguenti sono true:

  • La regola di invio del report non esiste (il cmdlet Get-ReportSubmissionRule non restituisce alcun output).
  • I criteri di invio del report esistono (il cmdlet Get-ReportSubmissionPolicy restituisce l'output).

Il parametro SentTo identifica l'indirizzo di posta elettronica della cassetta postale di report. L'organizzazione ha bisogno di una regola di invio del report solo per inviare messaggi segnalati dall'utente alla cassetta postale di report usando microsoft o strumenti di creazione di report di terze parti in Outlook (l'esperienza di creazione di report integrata Microsoft è attivata).

Quando si imposta l'indirizzo di posta elettronica della cassetta postale di report nel portale di Microsoft 365 Defender in https://security.microsoft.com/securitysettings/userSubmission, lo stesso indirizzo di posta elettronica viene impostato anche nei cmdlet *-ReportSubmissionPolicy:

  • Creazione di report integrata microsoft tramite gli strumenti di creazione di report Microsoft in Outlook: ReportJunkAddresses, ReportNotJunkAddresses e ReportPhishAddresses (tutti e tre devono essere lo stesso valore).
  • Creazione di report integrata microsoft tramite strumenti di creazione di report di terze parti in Outlook: ThirdPartyReportAddresses.

Quando si usa questo cmdlet per impostare l'indirizzo di posta elettronica della cassetta postale di report, i parametri corrispondenti nei cmdlet *-ReportSubmissionPolicy non vengono aggiornati.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Esempio

Esempio 1

New-ReportSubmissionRule -Name DefaultReportSubmissionRule -ReportSubmissionPolicy DefaultReportSubmissionPolicy -SendTo "userreportedmessages@contoso.onmicrosoft.com"

In questo esempio viene creata la regola di invio del report. La cassetta postale di report è userreportedmessages@contoso.onmicrosoft.com.

Parametri

-Comments

Il parametro Comments consente di specificare commenti informativi sulla regola, ad esempio per cosa viene utilizzata la regola o come è cambiata nel tempo. La lunghezza del commento non può superare i 1024 caratteri.

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

-Confirm

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.

  • I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi: -Confirm:$false.
  • La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Enabled

Il parametro Enabled consente di specificare se la regola è abilitata o disabilitata. I valori validi sono:

  • $true: la regola è abilitata. Questo è il valore predefinito.
  • $false: la regola è disabilitata.

Dopo aver creato la regola, usare i cmdlet Enable-ReportSubmissionRule e Disable-ReportSubmissionRule per abilitare o disabilitare la regola.

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

-Name

Il parametro Name consente di specificare il nome della regola di invio del report. Quando la regola viene creata automaticamente, il nome della regola è DefaultReportSubmissionRule. È consigliabile usare questo valore per evitare confusione.

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

-ReportSubmissionPolicy

Il parametro ReportSubmissionPolicy consente di specificare i criteri di invio del report associati a questa regola. L'unico criterio disponibile è denominato DefaultReportSubmissionPolicy.

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

-SentTo

Il parametro SentTo consente di specificare l'indirizzo di posta elettronica della cassetta postale di report in Exchange Online in cui vengono inviati i messaggi segnalati dall'utente.

Il valore di questo parametro è significativo solo se l'esperienza di creazione di report integrata Microsoft è abilitata e i messaggi segnalati dall'utente vengono inviati a una cassetta postale di report come configurato nei cmdlet *-ReportSubmissionPolicy (uno degli scenari seguenti):

  • La creazione di report integrata Microsoft è abilitata tramite gli strumenti di creazione di report Microsoft in Outlook: -EnableThirdPartyAddress $false -ReportJunkToCustomizedAddress $true -ReportNotJunkToCustomizedAddress $true -ReportPhishToCustomizedAddress $true.
  • La creazione di report integrata Microsoft è abilitata usando strumenti di creazione di report di terze parti in Outlook: -EnableReportToMicrosoft $false -EnableThirdPartyAddress $true -ReportJunkToCustomizedAddress $false -ReportNotJunkToCustomizedAddress $false -ReportPhishToCustomizedAddress $false.

Se si imposta l'indirizzo di posta elettronica della cassetta postale di report nel portale di Microsoft 365 Defender, i parametri seguenti nei cmdlet *-ReportSubmissionPolicy vengono impostati sullo stesso valore:

  • Creazione di report integrata microsoft tramite gli strumenti di creazione di report Microsoft in Outlook: ReportJunkAddresses, ReportNotJunkAddresses e ReportPhishAddresses (tutti e tre devono essere lo stesso valore).
  • Creazione di report integrata microsoft tramite strumenti di creazione di report di terze parti in Outlook: ThirdPartyReportAddresses.

Quando si usa questo cmdlet per impostare l'indirizzo di posta elettronica della cassetta postale di report, i valori dei parametri correlati nei cmdlet *-ReportSubmissionPolicy non vengono aggiornati, il che non influisce sulle funzionalità della cassetta postale di report. È consigliabile aggiornare i valori correlati nei cmdlet *-ReportSubmissionPolicy per coerenza ed evitare confusione.

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

-WhatIf

L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.

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