Set-AtpPolicyForO365

  • Référence
Module:
ExchangePowerShell
S’applique à:
Exchange Online

Cette cmdlet est disponible uniquement dans le service cloud.

Utilisez l’applet de commande Set-AtpPolicyForO365 pour modifier les paramètres des fonctionnalités suivantes dans Microsoft Defender pour Office 365 :

  • Protection des liens fiables pour les applications Office 365 prises en charge.
  • Documents sécurisés : utilise Microsoft Defender pour point de terminaison pour analyser les documents et les fichiers ouverts en mode protégé dans les applications Microsoft 365 pour entreprise.
  • Pièces jointes sécurisées pour SharePoint, OneDrive et Microsoft Teams.

Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.

Syntax

Set-AtpPolicyForO365
   [[-Identity] <AtpPolicyForO365IdParameter>]
   [-AllowSafeDocsOpen <Boolean>]
   [-BlockUrls <MultiValuedProperty>]
   [-Confirm]
   [-EnableATPForSPOTeamsODB <Boolean>]
   [-EnableSafeDocs <Boolean>]
   [-WhatIf]
   [<CommonParameters>]

Description

La protection des liens fiables pour les applications Office 365 vérifie les liens dans les documents Office, et non les liens dans les e-mails. Pour plus d’informations, consultez [Paramètres des liens fiables pour les applications Office 365](https://learn.microsoft.com/microsoft-365/security/office-365-security/safe-links-about#safe-links-settings-for-office-365-apps.

Documents sécurisés analyse les documents et les fichiers ouverts en mode protégé. Pour plus d’informations, consultez Documents sécurisés dans Microsoft 365 E5.

Les pièces jointes sécurisées pour SharePoint, OneDrive et Microsoft Teams empêchent les utilisateurs d’ouvrir et de télécharger des fichiers identifiés comme malveillants. Pour plus d’informations, voir Pièces jointes sécurisées pour SharePoint, OneDrive et Microsoft Teams.

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cette rubrique répertorie tous les paramètres de cette cmdlet, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour rechercher les autorisations requises pour exécuter une cmdlet ou un paramètre dans votre organisation, voir Find the permissions required to run any Exchange cmdlet.

Exemples

Exemple 1

Set-AtpPolicyForO365 -EnableATPForSPOTeamsODB $true

Cet exemple active les documents approuvés et les pièces jointes sécurisées pour SharePoint, OneDrive et Microsoft Teams.

Paramètres

-AllowSafeDocsOpen

Le paramètre AllowSafeDocsOpen spécifie si les utilisateurs peuvent cliquer et contourner le conteneur Mode protégé, même lorsque les documents sécurisés identifient un fichier comme malveillant. Les valeurs valides sont les suivantes :

  • $true : les utilisateurs sont autorisés à quitter le conteneur Mode protégé même si le document a été identifié comme malveillant.
  • $false : les utilisateurs ne sont pas autorisés à quitter le mode protégé en cas de détection malveillante.

Ce paramètre n’est significatif que lorsque la valeur du paramètre EnableSafeDocs est $true.

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

-BlockUrls

Ce paramètre est obsolète et inutilisé.

La fonctionnalité de ce paramètre a été remplacée par des entrées de bloc pour les URL dans la liste verte/bloquée du locataire à l’aide des applets de commande *-TenantAllowBlockListItems.

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

-Confirm

Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.

  • Les applets de commande destructrices (par exemple, les applets de commande Remove-*) ont une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.
  • La plupart des autres applets de commande (par exemple, les applets de commande New-* et Set-*) n’ont pas de pause intégrée. Pour ces cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-EnableATPForSPOTeamsODB

Le paramètre EnableATPForSPOTeamsODB active ou désactive les pièces jointes fiables pour SharePoint, OneDrive et Microsoft Teams. Les valeurs valides sont les suivantes :

  • $true : Les pièces jointes sécurisées pour SharePoint, OneDrive et Microsoft Teams sont activées. Les administrateurs SharePoint Online peuvent utiliser le paramètre DisallowInfectedFileDownload sur l’applet de commande Set-SPOTenant pour contrôler si les utilisateurs sont autorisés à télécharger des fichiers jugés malveillants.
  • $false : Les pièces jointes sécurisées pour SharePoint, OneDrive et Microsoft Teams sont désactivées. Il s’agit de la valeur par défaut.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-EnableSafeDocs

Le paramètre EnableSafeDocs active ou désactive les documents approuvés dans les organisations disposant de licences Microsoft 365 A5 ou Microsoft 365 E5 Sécurité. Les valeurs valides sont les suivantes :

  • $true : Documents sécurisés est activé et charge les fichiers utilisateur sur Microsoft Defender pour point de terminaison à des fins d’analyse et de vérification.
  • $false : Documents sécurisés est désactivé. Il s’agit de la valeur par défaut.

Pour plus d’informations sur les documents approuvés, consultez Documents sécurisés dans Microsoft 365 A5 ou sécurité E5

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

-Identity

Le paramètre Identity spécifie la stratégie que vous souhaitez modifier. Une seule stratégie est nommée Default.

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

-WhatIf

Le commutateur WhatIf simule les actions de la commande. Vous pouvez utiliser ce commutateur pour afficher les modifications qui se produiraient sans réellement appliquer ces modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

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