New-SafeAttachmentPolicy
Cette cmdlet est disponible uniquement dans le service cloud.
Utilisez l’applet de commande New-SafeAttachmentPolicy pour créer des stratégies de pièces jointes sécurisées dans votre organization cloud.
Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.
Syntaxe
Default (Par défaut)
New-SafeAttachmentPolicy
[-Name] <String>
[-Action <SafeAttachmentAction>]
[-AdminDisplayName <String>]
[-Confirm]
[-Enable <Boolean>]
[-MakeBuiltInProtection]
[-QuarantineTag <String>]
[-RecommendedPolicyType <RecommendedPolicyType>]
[-Redirect <Boolean>]
[-RedirectAddress <SmtpAddress>]
[-WhatIf]
[<CommonParameters>]
Description
Les pièces jointes sécurisées sont une fonctionnalité de Microsoft Defender pour Office 365 qui ouvre les pièces jointes dans un environnement d’hyperviseur spécial afin de détecter toute activité malveillante. Pour plus d’informations, voir Pièces jointes fiables dans Defender pour Office 365.
Les nouvelles stratégies de pièces jointes sécurisées que vous créez à l’aide de cette applet de commande ne sont pas appliquées aux utilisateurs et ne sont pas visibles dans le portail Microsoft Defender. Vous devez utiliser le paramètre SafeAttachmentPolicy sur les applets de commande New-SafeAttachmentRule ou Set-SafeAttachmentRule pour associer la stratégie à une règle afin de créer une stratégie de pièces jointes sécurisées complète visible dans le portail Defender.
Une stratégie de pièce jointe sécurisée ne peut être attribuée qu’à une seule règle de pièce jointe sécurisée.
Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cet article répertorie tous les paramètres de l’applet de commande, il se peut que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous sont 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
New-SafeAttachmentPolicy -Name "Marketing Block Attachments" -Enable $true -Redirect $true -RedirectAddress admin@contoso.com
Cet exemple crée une stratégie de pièce jointe sécurisée nommée Marketing Block Attachments avec les options suivantes :
- L’action est Block. Cette valeur étant la valeur par défaut du paramètre Action, vous n’avez donc pas besoin de la spécifier.
- La valeur $true pour le paramètre Enable est obligatoire afin que la stratégie utilise réellement la valeur par défaut du paramètre Action Block (Bloc) (ou toute autre valeur de paramètre Action).
- Activez la redirection pour les pièces jointes de programmes malveillants détectées et envoyez les messages à
admin@contoso.com. - Si l’analyse des pièces jointes fiables n’est pas disponible ou rencontre des erreurs, ne remettez pas le message normalement. La valeur par défaut du paramètre ActionOnError est $true, vous n’avez donc pas besoin de la spécifier.
Paramètres
-Action
Applicable : Exchange Online
Le paramètre Action spécifie l’action pour la stratégie de pièce jointe. Les valeurs valides sont les suivantes :
- Autoriser : Transmettre le message si un logiciel malveillant est détecté dans la pièce jointe et suivre les résultats de l’analyse. Cette valeur correspond à la surveillance de la propriété de réponse aux programmes malveillants inconnus des pièces jointes sécurisées de la stratégie dans le portail Microsoft Defender.
- Bloquer : bloquez l’e-mail qui contient la pièce jointe du programme malveillant. Cette valeur est la valeur par défaut.
- DynamicDelivery : remettez l’e-mail avec un espace réservé pour chaque pièce jointe. L’espace réservé reste jusqu’à ce qu’une copie de la pièce jointe soit analysée et déterminée comme étant sûre. Pour plus d’informations, voir Livraison dynamique dans des stratégies de pièces jointes fiables.
La valeur de ce paramètre n’a de sens que si la valeur du paramètre Enable est $true (la valeur par défaut est $false).
Pour ne spécifier aucune action pour la stratégie de pièce jointe sécurisée (correspond à la valeur Désactivée pour le paramètre de stratégie de réponse aux programmes malveillants inconnus des pièces jointes sécurisées dans le portail Defender), utilisez la valeur $false pour le paramètre Activer.
Le résultat de toutes les actions sont disponibles dans le suivi des messages.
Propriétés du paramètre
| Type: | SafeAttachmentAction |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-AdminDisplayName
Applicable : Exchange Online
Le paramètre AdminDisplayName spécifie une description de la stratégie. Si la valeur contient des espaces, placez-la entre guillemets (").
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Confirm
Applicable : Exchange Online
Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’impact de ce commutateur sur l’applet de commande varie selon que l’applet de commande nécessite une confirmation avant de continuer.
- Les applets de commande destructrices (par exemple, les applets de commande Remove-*) comportent 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 applets de commande, la spécification du commutateur Confirmer sans valeur introduit une pause qui vous oblige à accuser réception de la commande avant de continuer.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Enable
Applicable : Exchange Online
Le paramètre Enable fonctionne avec le paramètre Action pour spécifier l’action de la stratégie de pièce jointe. Les valeurs valides sont les suivantes :
- $true : le paramètre Action spécifie l’action pour la stratégie de pièce jointe.
- $false : cette valeur est la valeur par défaut. Les pièces jointes ne sont pas analysées par les pièces jointes fiables, quelle que soit la valeur du paramètre Action. Cette valeur correspond à la sélection désactivée pour le paramètre de réponse des programmes malveillants inconnus des pièces jointes sécurisées de la stratégie dans le portail Microsoft Defender.
Pour activer ou désactiver une stratégie complète de pièces jointes sécurisées dans le portail Microsoft Defender (combinaison de la règle et de la stratégie associée correspondante dans PowerShell), utilisez les applets de commande Enable-SafeAttachmentRule ou Disable-SafeAttachmentRule.
Propriétés du paramètre
| Type: | Boolean |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-MakeBuiltInProtection
Applicable : Exchange Online
Le commutateur MakeBuiltInProtection est utilisé pour la création de stratégies de protection intégrées dans le cadre de stratégies de sécurité prédéfinies. N’utilisez pas ce commutateur vous-même.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Name
Applicable : Exchange Online
Le paramètre Nom spécifie un nom unique pour la stratégie de pièce jointe. Si la valeur contient des espaces, placez-la entre guillemets (").
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-QuarantineTag
Applicable : Exchange Online
Le paramètre QuarantineTag spécifie la stratégie de quarantaine utilisée sur les messages mis en quarantaine en tant que programmes malveillants par des pièces jointes fiables. Vous pouvez utiliser n’importe quelle valeur qui identifie de manière unique la stratégie de quarantaine. Par exemple :
- Nom
- Nom unique (DN)
- GUID
Les stratégies de quarantaine définissent ce que les utilisateurs peuvent faire sur les messages mis en quarantaine en fonction de la raison pour laquelle le message a été mis en quarantaine et des paramètres de notification de quarantaine. Pour plus d’informations sur les stratégies de quarantaine, consultez Stratégies de quarantaine.
Si vous n’utilisez pas ce paramètre, la stratégie de quarantaine intégrée nommée AdminOnlyAccessPolicy est utilisée. Cette stratégie de quarantaine applique les fonctionnalités historiques pour les messages qui ont été mis en quarantaine en tant que programmes malveillants par des pièces jointes fiables, comme décrit dans le tableau ci-dessous.
Pour afficher la liste des stratégies de quarantaine disponibles, exécutez la commande suivante : Get-QuarantinePolicy | Format-List Name,EndUser*,ESNEnabled.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-RecommendedPolicyType
Applicable : Exchange Online
Le paramètre RecommendedPolicyType est utilisé pour la création de stratégies Standard et Strictes dans le cadre des stratégies de sécurité prédéfinies. N’utilisez pas ce paramètre vous-même.
Propriétés du paramètre
| Type: | RecommendedPolicyType |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Redirect
Applicable : Exchange Online
Le paramètre Redirect spécifie s’il faut remettre les messages à une autre adresse e-mail si un programme malveillant est détecté dans une pièce jointe. Les valeurs valides sont les suivantes :
- $true : les messages qui contiennent des pièces jointes malveillantes sont remis à l’adresse e-mail spécifiée par le paramètre RedirectAddress. Cette valeur n’a de sens que lorsque la valeur du paramètre Action est Allow.
- $false : les messages qui contiennent des pièces jointes malveillantes ne sont pas remis à une autre adresse e-mail. Cette valeur est la valeur par défaut.
Propriétés du paramètre
| Type: | Boolean |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-RedirectAddress
Applicable : Exchange Online
Le paramètre RedirectAddress spécifie l’adresse e-mail de destination pour remettre les messages si un programme malveillant est détecté dans une pièce jointe.
La valeur de ce paramètre n’est significative que lorsque la valeur du paramètre Redirect est $true et que la valeur du paramètre Action est Allow.
Propriétés du paramètre
| Type: | SmtpAddress |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Applicable : Exchange Online
Le commutateur WhatIf affiche ce que la commande fait sans apporter de modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.