Freigeben über


New-ReportSubmissionRule

Dieses Cmdlet ist nur im cloudbasierten Dienst verfügbar.

Verwenden Sie das Cmdlet New-ReportSubmissionRule, um die Berichtsübermittlungsregel in Ihrer cloudbasierten organization zu erstellen. Die Berichtsübermittlungsregel identifiziert das Berichtspostfach, in dem vom Benutzer gemeldete Nachrichten übermittelt werden.

Hinweis: Wenn die Regel bereits vorhanden ist (das Get-ReportSubmissionRule Cmdlet gibt die Ausgabe zurück), können Sie dieses Cmdlet nicht verwenden. Um die vorhandene Regel zu löschen und von vorne zu beginnen, verwenden Sie zuerst das Cmdlet Remove-ReportSubmissionRule.

Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.

Syntax

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

Beschreibung

Sie können dieses Cmdlet nur verwenden, wenn die folgenden Anweisungen zutreffen:

  • Die Berichtsübermittlungsregel ist nicht vorhanden (das Cmdlet Get-ReportSubmissionRule gibt keine Ausgabe zurück).
  • Die Berichtsübermittlungsrichtlinie ist vorhanden (das cmdlet Get-ReportSubmissionPolicy gibt die Ausgabe zurück).

Der Parameter SentTo identifiziert die E-Mail-Adresse des Berichtspostfachs. Ihr organization benötigt nur eine Berichtsübermittlungsregel, um vom Benutzer gemeldete Nachrichten mithilfe von Microsoft oder Berichterstellungstools von Drittanbietern in Outlook an das Berichterstellungspostfach zu senden (die integrierte Benutzeroberfläche von Microsoft ist aktiviert).

Wenn Sie die E-Mail-Adresse des Berichtspostfachs im Microsoft 365 Defender-Portal unter https://security.microsoft.com/securitysettings/userSubmissionfestlegen, wird dieselbe E-Mail-Adresse auch in den Cmdlets *-ReportSubmissionPolicy festgelegt:

  • Integrierte Berichterstellung mit Microsoft-Berichterstellungstools in Outlook: ReportJunkAddresses, ReportNotJunkAddresses und ReportPhishAddresses (alle drei müssen denselben Wert aufweisen).
  • Integrierte Berichterstellung von Microsoft mithilfe von Berichtstools von Drittanbietern in Outlook: ThirdPartyReportAddresses.

Wenn Sie dieses Cmdlet verwenden, um die E-Mail-Adresse des Berichtspostfachs festzulegen, werden die entsprechenden Parameter in den *-ReportSubmissionPolicy-Cmdlets nicht aktualisiert.

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Auch wenn in diesem Thema alle Parameter für das Cmdlet aufgeführt werden, verfügen Sie möglicherweise nicht über den Zugriff auf einige Parameter, wenn sie nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Wie Sie herausfinden, welche Berechtigungen zur Ausführung eines bestimmten Cmdlets oder Parameters in Ihrer Organisation erforderlich sind, können Sie unter Find the permissions required to run any Exchange cmdlet nachlesen.

Beispiele

Beispiel 1

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

In diesem Beispiel wird die Berichtsübermittlungsregel erstellt. Das Berichterstellungspostfach ist userreportedmessages@contoso.onmicrosoft.com.

Parameter

-Comments

Der Comments-Parameter gibt informative Kommentare für die Regel an, z. B. wofür die Regel verwendet wird oder wie sie im Lauf der Zeit geändert wurde. Die Länge des Kommentars darf 1024 Zeichen nicht überschreiten.

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

-Confirm

Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie diese Option sich auf das Cmdlet auswirkt, hängt davon ab, ob für die Option vor dem Fortfahren eine Bestätigung erforderlich ist.

  • Destruktive Cmdlets (z. B. Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen: -Confirm:$false.
  • Die meisten anderen Cmdlets (z. B. New-* und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt das Angeben der Option "Confirm" ohne einen Wert eine Pause ein, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Enabled

Der Parameter Enabled gibt an, ob die Regel aktiviert oder deaktiviert ist. Gültige Werte sind:

  • $true: Die Regel ist aktiviert. Dies ist der Standardwert.
  • $false: Die Regel ist deaktiviert.

Nachdem Sie die Regel erstellt haben, verwenden Sie die Cmdlets Enable-ReportSubmissionRule und Disable-ReportSubmissionRule, um die Regel zu aktivieren oder zu deaktivieren.

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

-Name

Der Parameter Name gibt den Namen der Berichtsübermittlungsregel an. Wenn die Regel automatisch erstellt wird, lautet der Name der Regel DefaultReportSubmissionRule. Es wird empfohlen, diesen Wert zu verwenden, um Verwirrung zu vermeiden.

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

-ReportSubmissionPolicy

Der Parameter ReportSubmissionPolicy gibt die Berichtsübermittlungsrichtlinie an, die dieser Regel zugeordnet ist. Die einzige verfügbare Richtlinie heißt DefaultReportSubmissionPolicy.

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

-SentTo

Der Parameter SentTo gibt die E-Mail-Adresse des Berichterstellungspostfachs in Exchange Online an, an die vom Benutzer gemeldete Nachrichten gesendet werden.

Der Wert dieses Parameters ist nur dann von Bedeutung, wenn die integrierte Microsoft-Berichterstellung aktiviert ist und vom Benutzer gemeldete Nachrichten gemäß der Konfiguration in den Cmdlets *-ReportSubmissionPolicy (eines der folgenden Szenarien) an ein Berichterstellungspostfach gesendet werden:

  • Die integrierte Microsoft-Berichterstellung wird mithilfe von Microsoft-Berichterstellungstools in Outlook aktiviert: -EnableThirdPartyAddress $false -ReportJunkToCustomizedAddress $true -ReportNotJunkToCustomizedAddress $true -ReportPhishToCustomizedAddress $true.
  • Die integrierte Berichterstellung von Microsoft wird mithilfe von Berichterstellungstools von Drittanbietern in Outlook aktiviert: -EnableReportToMicrosoft $false -EnableThirdPartyAddress $true -ReportJunkToCustomizedAddress $false -ReportNotJunkToCustomizedAddress $false -ReportPhishToCustomizedAddress $false.

Wenn Sie die E-Mail-Adresse des Berichtspostfachs im Microsoft 365 Defender-Portal festlegen, werden die folgenden Parameter in den Cmdlets *-ReportSubmissionPolicy auf denselben Wert festgelegt:

  • Integrierte Berichterstellung mit Microsoft-Berichterstellungstools in Outlook: ReportJunkAddresses, ReportNotJunkAddresses und ReportPhishAddresses (alle drei müssen denselben Wert aufweisen).
  • Integrierte Berichterstellung von Microsoft mithilfe von Berichtstools von Drittanbietern in Outlook: ThirdPartyReportAddresses.

Wenn Sie dieses Cmdlet verwenden, um die E-Mail-Adresse des Berichtspostfachs festzulegen, werden die zugehörigen Parameterwerte in den Cmdlets *-ReportSubmissionPolicy nicht aktualisiert, was sich nicht auf die Funktionalität des Berichtspostfachs auswirkt. Sie sollten die zugehörigen Werte in den Cmdlets *-ReportSubmissionPolicy aus Gründen der Konsistenz und zur Vermeidung von Verwechslungen aktualisieren.

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

-WhatIf

Die Option "WhatIf" simuliert die Aktionen des Befehls. Sie können diesen Switch verwenden, um die Änderungen anzuzeigen, die auftreten würden, ohne diese Änderungen tatsächlich anzuwenden. Sie müssen keinen Wert für diese Option angeben.

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