Set-AtpPolicyForO365
Dieses Cmdlet ist nur im cloudbasierten Dienst verfügbar.
Verwenden Sie das Cmdlet Set-AtpPolicyForO365, um die Einstellungen für die folgenden Features in Microsoft Defender for Office 365 zu ändern:
- Schutz von sicheren Links für unterstützte Office 365-Apps.
- Sichere Dokumente: Verwendet Microsoft Defender für Endpunkt, um Dokumente und Dateien zu scannen, die in der geschützten Ansicht in Microsoft 365 Apps for Enterprise geöffnet werden.
- Sichere Anlagen für SharePoint, OneDrive und Microsoft Teams.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
Default (Standard)
Set-AtpPolicyForO365
[[-Identity] <AtpPolicyForO365IdParameter>]
[-AllowSafeDocsOpen <Boolean>]
[-Confirm]
[-EnableATPForSPOTeamsODB <Boolean>]
[-EnableSafeDocs <Boolean>]
[-WhatIf]
[<CommonParameters>]
Beschreibung
Der Safe Links-Schutz für Office 365-Apps überprüft Links in Office-Dokumenten, nicht Links in E-Mail-Nachrichten. Weitere Informationen finden Sie unter Einstellungen für sichere Links für Office 365-Apps.
Safe Documents überprüft Dokumente und Dateien, die in der geschützten Ansicht geöffnet werden. Weitere Informationen finden Sie unter Sichere Dokumente in Microsoft 365 E5.
Sichere Anhänge für SharePoint, OneDrive und Microsoft Teams verhindert, dass Benutzer Dateien öffnen und herunterladen, die als bösartig identifiziert wurden. Weitere Informationen finden Sie unter Sichere Anhänge für SharePoint, OneDrive und Microsoft Teams.
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
Set-AtpPolicyForO365 -EnableATPForSPOTeamsODB $true
In diesem Beispiel werden sichere Dokumente und sichere Anhänge für SharePoint, OneDrive und Microsoft Teams aktiviert.
Parameter
-AllowSafeDocsOpen
Anwendbar: Exchange Online
Der Parameter AllowSafeDocsOpen gibt an, ob Benutzer sich durch den Container für die geschützte Ansicht klicken und ihn umgehen können, auch wenn Tresordokumente eine Datei als bösartig identifiziert haben. Gültige Werte sind:
- $true: Benutzer dürfen den Container für die geschützte Ansicht auch dann verlassen, wenn das Dokument als bösartig identifiziert wurde.
- $false: Benutzer dürfen die geschützte Ansicht nicht verlassen, falls eine böswillige Erkennung vorliegt.
Dieser Parameter ist nur dann von Bedeutung, wenn der EnableSafeDocs-Parameterwert $true ist.
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 |
-EnableATPForSPOTeamsODB
Anwendbar: Exchange Online
Der Parameter EnableATPForSPOTeamsODB aktiviert oder deaktiviert Sichere Anhänge für SharePoint, OneDrive und Microsoft Teams. Gültige Werte sind:
- $true: Sichere Anlagen für SharePoint, OneDrive und Microsoft Teams ist aktiviert. SharePoint-Administratoren können den DisallowInfectedFileDownload-Parameter des Set-SPOTenant-Cmdlets verwenden, um zu steuern, ob Benutzer Dateien herunterladen dürfen, die als bösartig eingestuft wurden.
- $false: Sichere Anhänge für SharePoint, OneDrive und Microsoft Teams sind deaktiviert. 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 |
-EnableSafeDocs
Anwendbar: Exchange Online
Der Parameter EnableSafeDocs aktiviert bzw. deaktiviert sichere Dokumente in Organisationen mit Microsoft 365 A5- oder Microsoft 365 E5 Security-Lizenzen. Gültige Werte sind:
- $true: Sichere Dokumente ist aktiviert und lädt Benutzerdateien zum Scannen und Überprüfen in Microsoft Defender for Endpoint hoch.
- $false: Sichere Dokumente ist deaktiviert. Dieser Wert ist der Standardwert.
Weitere Informationen zu sicheren Dokumenten finden Sie unter Sichere Dokumente in Microsoft 365 A5 oder E5-Sicherheit
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 |
-Identity
Anwendbar: Exchange Online
Der Parameter "Identity" gibt die Richtlinie an, die Sie ändern möchten. Es gibt nur eine Richtlinie „Default“.
Parametereigenschaften
| Typ: | AtpPolicyForO365IdParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| 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.