Freigeben über

Get-SafeLinksAggregateReport

Modul:
Exchange PowerShell

Dieses Cmdlet ist nur im cloudbasierten Dienst verfügbar.

Verwenden Sie das Cmdlet Get-SafeLinksAggregateReport, um allgemeine Informationen zu Ergebnissen sicherer Links für die letzten 90 Tage zurückzugeben. Gestern ist das letzte Datum, das Sie angeben können.

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

Syntax

Default (Standardwert) 

Get-SafeLinksAggregateReport

    [-Action <MultiValuedProperty>]
    [-AppNameList <MultiValuedProperty>]
    [-EndDate <System.DateTime>]
    [-StartDate <System.DateTime>]
    [-SummarizeBy <String>]
    [<CommonParameters>]

Beschreibung

Hinweis: Wenn Sie Get-SafeLinksAggregateReport ohne Angabe eines Datumsbereichs ausführen, gibt der Befehl einen nicht angegebenen Fehler zurück.

Sichere Links sind ein Feature in Microsoft Defender for Office 365, das Links in E-Mail-Nachrichten überprüft, um festzustellen, ob sie zu schädlichen Websites führen. Wenn ein Benutzer in einer Nachricht auf einen Link klickt, wird die URL vorübergehend umgeschrieben und anhand einer Liste bekannter, schädlicher Websites überprüft.

Für den Zeitraum, den Sie für die Berichterstellung angeben, werden mit dem Cmdlet die folgenden Informationen zurückgegeben:

  • Aktion
  • App
  • MessageCount
  • RecipientCount

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Obwohl in diesem Artikel alle Parameter für das Cmdlet aufgeführt sind, haben Sie möglicherweise keinen 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

Get-SafeLinksAggregateReport -StartDate 06-01-2020 -EndDate 06-10-2020 -SummarizeBy App -AppNameList "Email Client","Teams"

In diesem Beispiel werden Ergebnisse zurückgegeben, die von Email Client- und Teams-Ergebnissen für den angegebenen Datumsbereich zusammengefasst wurden.

Parameter

-Action

Anwendbar: Exchange Online

Der Action-Parameter filtert die Ergebnisse nach Aktion. Gültige Werte sind:

  • Allowed
  • Gesperrt
  • ClickedDuringScan
  • ClickedEvenBlocked
  • Analyse
  • TenantAllowed
  • TenantBlocked
  • TenantBlockedAndClickedThrough

Es können mehrere Werte durch Kommata getrennt angegeben werden.

Parametereigenschaften

Typ:MultiValuedProperty
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-AppNameList

Anwendbar: Exchange Online

Der Parameter AppNameList filtert die Ergebnisse nach der App, in der der Link gefunden wurde. Gültige Werte sind:

  • Email Client
  • OfficeDocs
  • Teams

Mehrere Werte können durch Kommata getrennt eingegeben werden. Wenn die Werte Leerzeichen oder anderweitig erforderliche Anführungszeichen enthalten, verwenden Sie die folgende Syntax: "Value1","Value2",..."ValueN".

Parametereigenschaften

Typ:MultiValuedProperty
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-EndDate

Anwendbar: Exchange Online

Der EndDate-Parameter gibt das Enddatum des Datumsbereichs an.

Verwenden Sie das unter "Regionale Einstellungen" definierte kurze Datumsformat für den Computer, auf dem der Befehl ausgeführt wird. Wenn der Computer beispielsweise für die Verwendung des kurzen Datumsformats MM/TT/jjjj konfiguriert ist, geben Sie 09/01/2018 ein, um den 1. September 2018 anzugeben.

Gestern ist das letzte Datum, das Sie angeben können. Sie können kein Datum angeben, das älter als 90 Tage ist.

Parametereigenschaften

Typ:System.DateTime
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-StartDate

Anwendbar: Exchange Online

Der StartDate-Parameter gibt das Startdatum und die Uhrzeit des Datumsbereichs an.

Verwenden Sie das unter "Regionale Einstellungen" definierte kurze Datumsformat für den Computer, auf dem der Befehl ausgeführt wird. Wenn der Computer beispielsweise für die Verwendung des kurzen Datumsformats MM/TT/jjjj konfiguriert ist, geben Sie 09/01/2018 ein, um den 1. September 2018 anzugeben.

Gestern ist das letzte Datum, das Sie angeben können. Sie können kein Datum angeben, das älter als 90 Tage ist.

Parametereigenschaften

Typ:System.DateTime
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SummarizeBy

Anwendbar: Exchange Online

Der SummarizeBy-Parameter gibt Summen basierend auf den Werten zurück, die Sie angeben. Wenn in Ihrem Bericht Daten unter Verwendung eines von diesem Parameter akzeptierten Werts gefiltert werden, können Sie den SummarizeBy-Parameter verwenden, um die Ergebnisse basierend auf diesen Werten zusammenzufassen. Damit im Bericht weniger Zeilen zurückgegeben werden, können Sie den SummarizeBy-Parameter verwenden. Durch das Zusammenfassen wird die Menge der Daten verkleinert, die für den Bericht abgerufen werden, und der Bericht wird schneller erzeugt. Anstatt beispielsweise jede instance eines bestimmten Werts von Action oder AppNameList in einer einzelnen Zeile im Bericht anzuzeigen, können Sie den SummarizeBy-Parameter verwenden, um die Gesamtzahl der Instanzen dieser bestimmten Aktion oder App in einer Zeile im Bericht anzuzeigen.

Für dieses Cmdlet sind folgende Werte gültig:

  • Aktion: Nur die vom Action-Parameter angegebenen Werte werden zurückgegeben.
  • App: Nur die vom AppNameList-Parameter angegebenen Werte werden zurückgegeben.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.