New-SafeLinksPolicy
Dieses Cmdlet ist nur im cloudbasierten Dienst verfügbar.
Verwenden Sie das Cmdlet New-SafeLinksPolicy, um in der cloudbasierten Organisation Richtlinien für sichere Links zu erstellen.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
Default (Standard)
New-SafeLinksPolicy
[-Name] <String>
[-AdminDisplayName <String>]
[-AllowClickThrough <Boolean>]
[-Confirm]
[-CustomNotificationText <String>]
[-DeliverMessageAfterScan <Boolean>]
[-DisableUrlRewrite <Boolean>]
[-DoNotRewriteUrls <MultiValuedProperty>]
[-EnableForInternalSenders <Boolean>]
[-EnableOrganizationBranding <Boolean>]
[-EnableSafeLinksForEmail <Boolean>]
[-EnableSafeLinksForOffice <Boolean>]
[-EnableSafeLinksForTeams <Boolean>]
[-MakeBuiltInProtection]
[-RecommendedPolicyType <RecommendedPolicyType>]
[-ScanUrls <Boolean>]
[-TrackClicks <Boolean>]
[-UseTranslatedNotificationText <Boolean>]
[-WhatIf]
[<CommonParameters>]
Beschreibung
Safe Links ist ein Feature in Microsoft Defender für Office 365, das Links überprüft, um festzustellen, ob sie zu schädlichen Websites führen. Wenn ein Benutzer auf einen Link klickt, wird die URL vorübergehend umgeschrieben und mit einer Liste bekannter, schädlicher Websites abgeglichen. Sichere Links umfassen das Feature zum Melden der URL-Ablaufverfolgung, um festzustellen, wer auf eine schädliche Website geklickt hat.
Neue Richtlinien, die Sie mit diesem Cmdlet erstellen, werden nicht auf Benutzer angewendet und sind in Admin Centern nicht sichtbar. Sie müssen den SafeLinksPolicy-Parameter im New-SafeLinksRule oder Set-SafeLinksRule Cmdlets verwenden, um die Richtlinie einer Regel zuzuordnen.
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
New-SafeLinksPolicy -Name "Marketing Block URL" -EnableSafeLinksForEmail $true -AllowClickThrough $false
In diesem Beispiel wird eine neue Richtlinie für sichere Links mit der Bezeichnung „Marketing Block URL“ und den folgenden Optionen erstellt:
- Die Richtlinie ist aktiviert.
- Benutzer dürfen nicht auf die ursprüngliche URL klicken.
- Benutzerklicks auf URLs werden nachverfolgt. Dieser Wert ist der Standardwert des TrackClicks-Parameters, sodass Sie ihn nicht angeben müssen.
Parameter
-AdminDisplayName
Anwendbar: Exchange Online
Der Parameter AdminDisplayName gibt eine Beschreibung für die Richtlinie an. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").
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 |
-AllowClickThrough
Anwendbar: Exchange Online
Der Parameter AllowClickThrough gibt an, ob Benutzer auf Warnseiten zur ursprünglichen URL durchklicken dürfen. Gültige Werte sind:
- $true: Der Benutzer darf sich zur ursprünglichen URL durchklicken.
- $false: Der Benutzer darf nicht auf die ursprüngliche URL klicken.
In PowerShell ist der Standardwert $false. In neuen Richtlinien für sichere Links, die im Microsoft Defender-Portal erstellt werden, ist der Standardwert $true.
Parametereigenschaften
| Typ: | Boolean |
| 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 |
-Confirm
Anwendbar: Exchange Online
Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie sich diese Option auf das Cmdlet auswirkt, hängt davon ab, ob für das Cmdlet eine Bestätigung erforderlich ist, bevor Sie fortfahren.
- Destruktive Cmdlets (beispielsweise Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen:
-Confirm:$false. - Die meisten anderen Cmdlets (beispielsweise New-*- und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt die Angabe des Bestätigungsschalters ohne Wert zu einer Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-CustomNotificationText
Anwendbar: Exchange Online
Der benutzerdefinierte Benachrichtigungstext gibt den angepassten Benachrichtigungstext an, der Benutzern angezeigt werden soll. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").
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 |
-DeliverMessageAfterScan
Anwendbar: Exchange Online
Der Parameter DeliverMessageAfterScan gibt an, ob E-Mail-Nachrichten erst nach Abschluss des Tresor-Links-Scans zugestellt werden sollen. Gültige Werte sind:
- $true: Warten Sie, bis die Tresor Links-Überprüfung abgeschlossen ist, bevor Sie die Nachricht übermitteln. Nachrichten, die bösartige Links enthalten, werden nicht zugestellt. Dieser Wert ist der Standardwert.
- $false: Wenn die Überprüfung von sicheren Verknüpfungen nicht abgeschlossen werden kann, stellen Sie die Nachricht trotzdem zu.
Parametereigenschaften
| Typ: | Boolean |
| 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 |
-DisableUrlRewrite
Anwendbar: Exchange Online
Der Parameter DisableUrlRewrite gibt an, ob URLs in E-Mail-Nachrichten umgeschrieben (umschlossen) werden sollen. Gültige Werte sind:
- $true: URLs in Nachrichten werden nicht umgeschrieben, aber Nachrichten werden vor der Übermittlung weiterhin von Tresor Links gescannt. Die Überprüfung des Klicks auf Links erfolgt mithilfe der API für sichere Links in unterstützten Outlook-Clients (derzeit Outlook für Windows und Outlook für Mac).
- $false: URLs in Nachrichten werden umgeschrieben. API-Prüfungen erfolgen weiterhin für nicht umschlossene URLs in unterstützten Clients, wenn sich der Benutzer in einer gültigen Safe Links-Richtlinie befindet. Dieser Wert ist der Standardwert.
In PowerShell ist der Standardwert $false. In neuen Richtlinien für sichere Links, die im Microsoft Defender-Portal erstellt werden, ist der Standardwert $true.
Parametereigenschaften
| Typ: | Boolean |
| 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 |
-DoNotRewriteUrls
Anwendbar: Exchange Online
Der Parameter DoNotRewriteUrls gibt die URLs an, die nicht durch die Überprüfung sicherer Links umgeschrieben werden. Die Liste der Einträge ermöglicht Benutzern, die in der Richtlinie enthalten sind, den Zugriff auf die angegebenen URLs, die andernfalls von sicheren Links blockiert würden.
Verwenden Sie zum Eingeben mehrerer Werte und zum Überschreiben vorhandener Einträge die folgende Syntax: Value1,Value2,...ValueN. Wenn die Werte Leerzeichen oder anderweitig erforderliche Anführungszeichen enthalten, verwenden Sie die folgende Syntax: "Value1","Value2",..."ValueN".
Verwenden Sie die folgende Syntax, um mindestens einen Wert hinzuzufügen oder zu entfernen, ohne dass dies Auswirkungen auf vorhandene Einträge hat: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Ausführliche Informationen zur Eintragssyntax finden Sie unter Eingabesyntax für die Liste "Schreiben Sie die folgenden URLs nicht um".
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 |
-EnableForInternalSenders
Anwendbar: Exchange Online
Der Parameter EnableForInternalSenders gibt an, ob die Richtlinie für sichere Links auf Nachrichten angewendet wird, die zwischen internen Absendern und internen Empfängern innerhalb derselben Exchange Online organization gesendet werden. Gültige Werte sind:
- $true: Die Richtlinie gilt für interne und externe Absender. Dieser Wert ist der Standardwert.
- $false: Die Richtlinie wird nur auf externe Absender angewendet.
Parametereigenschaften
| Typ: | Boolean |
| 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 |
-EnableOrganizationBranding
Anwendbar: Exchange Online
Der Parameter EnableOrganizationBranding gibt an, ob das Logo Ihrer organization auf Warn- und Benachrichtigungsseiten für sichere Links angezeigt wird. Gültige Werte sind:
- $true: Das Organisationsbranding wird auf den Warn- und Benachrichtigungsseiten für sichere Links angezeigt. Bevor Sie diesen Wert konfigurieren, müssen Sie die Anweisungen unter Anpassen des Microsoft 365-Designs für Ihre Organization befolgen, um Ihr Firmenlogo hochzuladen.
- $false: Organisationsbranding wird auf den Warnungs- und Benachrichtigungsseiten für sichere Links nicht angezeigt. Dieser Wert ist der Standardwert.
Parametereigenschaften
| Typ: | Boolean |
| 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 |
-EnableSafeLinksForEmail
Anwendbar: Exchange Online
Der Parameter EnableSafeLinksForEmail gibt an, ob der Safe Links-Schutz für E-Mail-Nachrichten aktiviert werden soll. Gültige Werte sind:
- $true: Sichere Links sind für E-Mails aktiviert. Dieser Wert ist der Standardwert. Wenn ein Benutzer auf einen Link in einer E-Mail klickt, wird der Link von Tresor Links überprüft. Wenn der Link als schädlich eingestuft wird, wird im Standardwebbrowser eine Warnseite angezeigt.
- $false: Tresor Links ist für E-Mails nicht aktiviert.
Parametereigenschaften
| Typ: | Boolean |
| 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 |
-EnableSafeLinksForOffice
Anwendbar: Exchange Online
Der Parameter EnableSafeLinksForOffice gibt an, ob der Schutz von sicheren Links für unterstützte Office-Desktop-, mobile oder Web-Apps aktiviert werden soll. Gültige Werte sind:
- $true: Das Scannen sicherer Links ist in Office-Apps aktiviert. Dieser Wert ist der Standardwert. Wenn ein Benutzer eine Datei in einer unterstützten Office-App öffnet und auf einen Link in der Datei klickt, wird der Link von Tresorlinks überprüft. Wenn der Link als schädlich eingestuft wird, wird im Standardwebbrowser eine Warnseite angezeigt.
- $false: Sichere Links sind für Office-Apps nicht aktiviert.
Dieser Schutz gilt für Links in Office-Dokumenten, nicht für Links in E-Mail-Nachrichten.
Parametereigenschaften
| Typ: | Boolean |
| 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 |
-EnableSafeLinksForTeams
Anwendbar: Exchange Online
Der Parameter EnableSafeLinksForTeams gibt an, ob Tresor Links für Microsoft Teams aktiviert ist. Gültige Werte sind:
- $true: Sichere Links sind für Teams aktiviert. Dieser Wert ist der Standardwert. Wenn ein Benutzer in einer Teams-Unterhaltung, einem Gruppenchat oder aus Kanälen auf einen Link klickt, wird der Link von Safe Links überprüft. Wenn der Link als schädlich eingestuft wird, wird im Standardwebbrowser eine Warnseite angezeigt.
- $false: Sichere Links sind für Teams nicht aktiviert.
Parametereigenschaften
| Typ: | Boolean |
| 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 |
-MakeBuiltInProtection
Anwendbar: Exchange Online
Der MakeBuiltInProtection-Schalter wird für die Erstellung integrierter Schutzrichtlinien als Teil voreingestellter Sicherheitsrichtlinien verwendet. Verwenden Sie diese Option nicht selbst.
Parametereigenschaften
| Typ: | SwitchParameter |
| 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 |
-Name
Anwendbar: Exchange Online
Der Name-Parameter gibt einen eindeutigen Namen für die Richtlinie für sichere Links an. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-RecommendedPolicyType
Anwendbar: Exchange Online
Der Parameter "RecommendedPolicyType" wird für die Erstellung von Standard- und strikten Richtlinien im Rahmen voreingestellter Sicherheitsrichtlinien verwendet. Verwenden Sie diesen Parameter nicht selbst.
Parametereigenschaften
| Typ: | RecommendedPolicyType |
| 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 |
-ScanUrls
Anwendbar: Exchange Online
Der Parameter ScanUrls gibt an, ob das Echtzeit-Scannen von angeklickten Links in E-Mail-Nachrichten aktiviert oder deaktiviert werden soll. Gültige Werte sind:
- $true: Das Echtzeit-Scannen von angeklickten Links, einschließlich Links, die auf Dateien verweisen, ist aktiviert. Dieser Wert ist der Standardwert.
- $false: Das Echtzeit-Scannen von angeklickten Links, einschließlich Links, die auf Dateien verweisen, ist deaktiviert.
Parametereigenschaften
| Typ: | Boolean |
| 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 |
-TrackClicks
Anwendbar: Exchange Online
Der TrackClicks-Parameter gibt an, ob Benutzerklicks im Zusammenhang mit dem Safe Links-Schutz von Links nachverfolgt werden sollen. Gültige Werte sind:
- $true: Benutzerklicksnachrichten werden nachverfolgt. Dieser Wert ist der Standardwert.
- $false: Nachrichten über Benutzerklicks werden nicht nachverfolgt.
Parametereigenschaften
| Typ: | Boolean |
| 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 |
-UseTranslatedNotificationText
Anwendbar: Exchange Online
Der UseTranslatedNotificationText gibt an, ob Microsoft Translator verwendet werden soll, um den benutzerdefinierten Benachrichtigungstext, den Sie mit dem Parameter CustomNotificationText angegeben haben, automatisch zu lokalisieren. Gültige Werte sind:
- $true: Übersetzen von benutzerdefiniertem Benachrichtigungstext in die Sprache des Benutzers.
- $false: Benutzerdefinierten Benachrichtigungstext nicht in die Sprache des Benutzers übersetzen. Dieser Wert ist der Standardwert.
Parametereigenschaften
| Typ: | Boolean |
| 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 |
-WhatIf
Anwendbar: Exchange Online
Der Schalter "WhatIf" zeigt die Funktion des Befehls an, ohne Änderungen vorzunehmen. Sie müssen keinen Wert für diese Option angeben.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
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.