Share via


Set-QuarantinePolicy

Cette cmdlet est disponible uniquement dans le service cloud.

Utilisez l’applet de commande Set-QuarantinePolicy pour modifier les stratégies de mise en quarantaine 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.

Syntax

Set-QuarantinePolicy
   [-Identity] <QuarantineTagIdParameter>
   [-AdminNotificationFrequencyInDays <Int32>]
   [-AdminNotificationLanguage <EsnLanguage>]
   [-AdminNotificationsEnabled <Boolean>]
   [-AdminQuarantinePermissionsList <MultiValuedProperty>]
   [-Confirm]
   [-CustomDisclaimer <String>]
   [-DomainController <Fqdn>]
   [-EndUserQuarantinePermissions <QuarantinePermissions>]
   [-EndUserQuarantinePermissionsValue <Int32>]
   [-EndUserSpamNotificationCustomFromAddress <String>]
   [-EndUserSpamNotificationFrequency <TimeSpan>]
   [-EndUserSpamNotificationFrequencyInDays <Int32>]
   [-EndUserSpamNotificationLanguage <EsnLanguage>]
   [-EsnCustomSubject <MultiValuedProperty>]
   [-ESNEnabled <Boolean>]
   [-IgnoreDehydratedFlag]
   [-MultiLanguageCustomDisclaimer <MultiValuedProperty>]
   [-MultiLanguageSenderName <MultiValuedProperty>]
   [-MultiLanguageSetting <MultiValuedProperty>]
   [-OrganizationBrandingEnabled <Boolean>]
   [-QuarantineRetentionDays <Int32>]
   [-WhatIf]
   [<CommonParameters>]

Description

Vous ne pouvez pas modifier les stratégies de mise en quarantaine intégrées nommées AdminOnlyAccessPolicy ou DefaultFullAccessPolicy.

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-QuarantinePolicy -Identity CustomAccess -EndUserQuarantinePermissionsValue 1

Cet exemple configure les autorisations dans la stratégie de mise en quarantaine nommée CustomAccess qui permet aux utilisateurs de supprimer uniquement les messages mis en quarantaine.

Exemple 2

Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy -MultiLanguageSetting ('English','ChineseSimplified','French') -MultiLanguageCustomDisclaimer ('For more information, contact the Help Desk.','有关更多信息,请联系服务台','Pour plus d''informations, contactez le service d''assistance.') -ESNCustomSubject ('You have quarantined messages','您有隔离邮件','Vous avez des messages en quarantaine') -MultiLanguageSenderName ('Contoso administrator','Contoso管理员','Administrateur Contoso') -EndUserSpamNotificationCustomFromAddress aashutosh@contso.onmicrosoft.com -OrganizationBrandingEnabled $true -EndUserSpamNotificationFrequency 04:00:00

Cet exemple modifie les paramètres globaux pour les notifications de mise en quarantaine (anciennement appelés paramètres de notification de courrier indésirable de l’utilisateur final) :

  • Les notifications de quarantaine sont personnalisées pour l’anglais, le chinois et Français. Des guillemets supplémentaires sont requis dans la valeur Français MultiLanguageCustomDisclaimer comme caractères d’échappement pour les guillemets dans le texte.
  • L’utilisateur aashutosh@contso.onmicrosoft.com existant est utilisé comme expéditeur de notification de mise en quarantaine.
  • Le logo personnalisé précédemment configuré remplace le logo Microsoft par défaut.
  • La fréquence des notifications de quarantaine passe à 4 heures.

Paramètres

-AdminNotificationFrequencyInDays

Ce paramètre est réservé à l’usage interne chez Microsoft.

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

-AdminNotificationLanguage

Ce paramètre est réservé à l’usage interne chez Microsoft.

Type:EsnLanguage
Accepted values:Default, English, French, German, Italian, Japanese, Spanish, Korean, Portuguese, Russian, ChineseSimplified, ChineseTraditional, Amharic, Arabic, Bulgarian, BengaliIndia, Catalan, Czech, Cyrillic, Danish, Greek, Estonian, Basque, Persian, Finnish, Filipino, Galician, Gujarati, Hebrew, Hindi, Croatian, Hungarian, Indonesian, Icelandic, Kazakh, Kannada, Lithuanian, Latvian, Malayalam, Marathi, Malay, Dutch, NorwegianNynorsk, Norwegian, Odia, Polish, PortuguesePortugal, Romanian, Slovak, Slovenian, SerbianCyrillic, Serbian, Swedish, Swahili, Tamil, Telugu, Thai, Turkish, Ukrainian, Urdu, Vietnamese
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-AdminNotificationsEnabled

Ce paramètre est réservé à l’usage interne chez Microsoft.

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

-AdminQuarantinePermissionsList

Ce paramètre est réservé à l’usage interne chez Microsoft.

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

-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, Exchange Online Protection

-CustomDisclaimer

Ce paramètre est réservé à l’usage interne chez Microsoft.

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

-DomainController

Ce paramètre est réservé à l’usage interne chez Microsoft.

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

-EndUserQuarantinePermissions

Ce paramètre est réservé à l’usage interne chez Microsoft.

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

-EndUserQuarantinePermissionsValue

Le paramètre EndUserQuarantinePermissionsValue spécifie les autorisations de l’utilisateur final pour la stratégie de mise en quarantaine.

Ce paramètre utilise une valeur décimale convertie à partir d’une valeur binaire. La valeur binaire correspond à la liste des autorisations disponibles dans un ordre spécifique. Pour chaque autorisation, la valeur 1 est égale à True et la valeur 0 est False. L’ordre requis est décrit dans la liste suivante, du plus élevé (1000000 ou 128) au plus bas (00000001 ou 1) :

  • PermissionToViewHeader : la valeur 0 ne masque pas l’action Afficher l’en-tête de message en quarantaine. Si le message est visible en quarantaine, l’action est toujours disponible pour le message.
  • PermissionToDownload : cette autorisation n’est pas utilisée (la valeur 0 ou 1 ne fait rien).
  • PermissionToAllowSender : cette autorisation n’est pas utilisée (la valeur 0 ou 1 ne fait rien).
  • PermissionToBlockSender
  • PermissionToRequestRelease : ne définissez pas cette autorisation et PermissionToRelease sur la valeur 1. Définissez une valeur sur 1 et l’autre sur 0, ou définissez les deux valeurs sur 0.
  • PermissionToRelease : ne définissez pas cette autorisation et PermissionToRequestRelease sur la valeur 1. Définissez une valeur sur 1 et l’autre sur 0, ou définissez les deux valeurs sur 0. Cette autorisation n’est pas respectée pour les messages mis en quarantaine en tant que programmes malveillants ou hameçonnage à haut niveau de confiance. Si la stratégie de mise en quarantaine accorde cette autorisation aux utilisateurs, les utilisateurs sont autorisés à demander la libération de leurs programmes malveillants en quarantaine ou de messages d’hameçonnage à haute confiance comme si PermissionToRequestRelease était sélectionné à la place.
  • PermissionToPreview
  • PermissionToDelete

Les valeurs des groupes d’autorisations d’utilisateur final prédéfinis sont décrites dans la liste suivante :

  • Aucun accès : Binary = 0000000, utilisez donc la valeur décimale 0.
  • Accès limité : Binaire = 00011011. Utilisez donc la valeur décimale 27.
  • Accès complet : Binaire = 00010111. Utilisez donc la valeur décimale 23.

Pour les autorisations personnalisées, obtenez la valeur binaire qui correspond aux autorisations souhaitées. Convertissez la valeur binaire en une valeur décimale à utiliser. N’utilisez pas la valeur binaire pour ce paramètre.

Remarque : si la valeur de ce paramètre est 0 (Aucun accès) et que la valeur du paramètre ESNEnabled est $true, les utilisateurs peuvent afficher leurs messages en quarantaine, mais la seule action disponible pour les messages est Afficher l’en-tête du message.

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

-EndUserSpamNotificationCustomFromAddress

EndUserSpamNotificationCustomFromAddress spécifie l’adresse e-mail d’un expéditeur interne existant à utiliser comme expéditeur pour les notifications de mise en quarantaine. Pour définir à nouveau ce paramètre sur l’adresse quarantine@messaging.microsoft.come-mail par défaut , utilisez la valeur $null.

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

-EndUserSpamNotificationFrequency

Le paramètre EndUserSpamNotificationFrequency indique la fréquence à laquelle les notifications de quarantaine sont envoyées aux utilisateurs. Les valeurs valides sont les suivantes :

  • 04:00:00 (4 heures)
  • 1.00:00:00 (1 jour)
  • 7.00:00:00 (7 jours)
Type:TimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-EndUserSpamNotificationFrequencyInDays

Ce paramètre est réservé à l’usage interne chez Microsoft.

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

-EndUserSpamNotificationLanguage

Ce paramètre est réservé à l’usage interne chez Microsoft.

Type:EsnLanguage
Accepted values:Default, English, French, German, Italian, Japanese, Spanish, Korean, Portuguese, Russian, ChineseSimplified, ChineseTraditional, Amharic, Arabic, Bulgarian, BengaliIndia, Catalan, Czech, Cyrillic, Danish, Greek, Estonian, Basque, Persian, Finnish, Filipino, Galician, Gujarati, Hebrew, Hindi, Croatian, Hungarian, Indonesian, Icelandic, Kazakh, Kannada, Lithuanian, Latvian, Malayalam, Marathi, Malay, Dutch, NorwegianNynorsk, Norwegian, Odia, Polish, PortuguesePortugal, Romanian, Slovak, Slovenian, SerbianCyrillic, Serbian, Swedish, Swahili, Tamil, Telugu, Thai, Turkish, Ukrainian, Urdu, Vietnamese
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-EsnCustomSubject

Le paramètre EsnCustomSubject spécifie le texte à utiliser dans le champ Objet des notifications de mise en quarantaine.

Vous pouvez spécifier plusieurs valeurs séparées par des virgules à l’aide de la syntaxe : ('value1',''value2',...'valueN'). Pour chaque langue que vous spécifiez avec le paramètre MultiLanguageSetting, vous devez spécifier un texte expéditeur unique. Veillez à aligner les valeurs des paramètres MultiLanguageSetting, MultiLanguageCustomDisclaimer, EsnCustomSubject et MultiLanguageSenderName dans le même ordre.

Pour modifier une valeur existante et conserver d’autres valeurs, vous devez spécifier toutes les valeurs existantes et la nouvelle valeur dans l’ordre existant.

Ce paramètre est disponible uniquement dans la stratégie de mise en quarantaine intégrée nommée DefaultGlobalTag qui contrôle les paramètres de stratégie de mise en quarantaine globale. Pour accéder à cette stratégie de mise en quarantaine, démarrez votre commande avec la syntaxe suivante : Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ....

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

-ESNEnabled

Le paramètre ESNEnabled spécifie s’il faut activer les notifications de quarantaine (anciennement appelées notifications de courrier indésirable de l’utilisateur final) pour la stratégie. Les valeurs valides sont les suivantes :

  • $true : les notifications de mise en quarantaine sont activées.
  • $false : les notifications de mise en quarantaine sont désactivées. L’utilisateur peut uniquement accéder aux messages mis en quarantaine en quarantaine, et non à Notifications par e-mail. Il s’agit de la valeur par défaut.

Remarque : Si la valeur de ce paramètre est $true et que la valeur du paramètre EndUserQuarantinePermissionsValue est 0 (Aucun accès lorsque toutes les autorisations sont désactivées), les utilisateurs peuvent afficher leurs messages en quarantaine, mais la seule action disponible pour les messages est Afficher l’en-tête du message.

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

-Identity

Le paramètre Identity spécifie la stratégie de mise en quarantaine que vous souhaitez modifier. Vous pouvez utiliser n’importe quelle valeur qui identifie de façon unique la stratégie de mise en quarantaine. Par exemple :

  • Nom
  • Nom unique (DN)
  • GUID
Type:QuarantineTagIdParameter
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-IgnoreDehydratedFlag

Ce paramètre est réservé à l’usage interne chez Microsoft.

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

-MultiLanguageCustomDisclaimer

Le paramètre MultiLanguageCustomDisclaimer spécifie le texte d’exclusion de responsabilité personnalisé à utiliser en bas des notifications de mise en quarantaine. Le texte localisé, Une clause d’exclusion de responsabilité de votre organization : est toujours inclus en premier, suivi du texte que vous spécifiez pour ce paramètre.

Vous pouvez spécifier plusieurs valeurs séparées par des virgules à l’aide de la syntaxe : ('value1',''value2',...'valueN'). Pour chaque langue que vous spécifiez avec le paramètre MultiLanguageSetting, vous devez spécifier un texte d’exclusion de responsabilité personnalisé unique. Veillez à aligner les valeurs des paramètres MultiLanguageSetting, MultiLanguageCustomDisclaimer, EsnCustomSubject et MultiLanguageSenderName dans le même ordre.

Pour modifier une valeur existante et conserver d’autres valeurs, vous devez spécifier toutes les valeurs existantes et la nouvelle valeur dans l’ordre existant.

Ce paramètre est disponible uniquement dans la stratégie de mise en quarantaine intégrée nommée DefaultGlobalTag qui contrôle les paramètres de stratégie de mise en quarantaine globale. Pour accéder à cette stratégie de mise en quarantaine, démarrez votre commande avec la syntaxe suivante : Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ....

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

-MultiLanguageSenderName

Le paramètre MultiLanguageSenderName spécifie le nom d’affichage de l’expéditeur de l’e-mail à utiliser dans les notifications de mise en quarantaine.

Vous pouvez spécifier plusieurs valeurs séparées par des virgules à l’aide de la syntaxe : ('value1',''value2',...'valueN'). Pour chaque langue que vous spécifiez avec le paramètre MultiLanguageSetting, vous pouvez spécifier un nom d’expéditeur unique. Veillez à aligner les valeurs des paramètres MultiLanguageSetting, MultiLanguageCustomDisclaimer et MultiLanguageSenderName correspondantes dans le même ordre.

Pour modifier une valeur existante et conserver d’autres valeurs, vous devez spécifier toutes les valeurs existantes et la nouvelle valeur dans l’ordre existant.

Ce paramètre est disponible uniquement dans la stratégie de mise en quarantaine intégrée nommée DefaultGlobalTag qui contrôle les paramètres globaux. Pour accéder à cette stratégie de mise en quarantaine, démarrez votre commande avec la syntaxe suivante : Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ....

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

-MultiLanguageSetting

Le paramètre MultiLanguageSetting spécifie la langue des notifications de mise en quarantaine. Les valeurs valides sont les suivantes :

Default, Amharic, Arabic, Basque, BengaliIndia, Bulgare, Catalan, ChineseSimplified, ChineseTraditional, Croate, Cyrillique, Tchèque, Danois, Néerlandais, Anglais, Estonien, Philippin, Finnois, Français, Galicien, Allemand, Grec, Gujarati, Hébreu, Hindi, Hongrois, Islandais, Indonésien, Italien, Japonais, Kannada, Kazakh, Coréen, Letton, Lituanien, Malayalam, Marathi, Norvégien, Norvégien, NorvégienNynorsk, Odia, Persan, Polonais, Portugais, PortugaisPortugal, Roumain, Russe, Serbe, SerbeCyrillic, Slovaque, slovène, espagnol, swahili, suédois, tamoul, télougou, thaï, turc, ukrainien, ourdou et vietnamien.

Vous pouvez spécifier plusieurs valeurs séparées par des virgules à l’aide de la syntaxe : ('value1',''value2',...'valueN'). La valeur par défaut est Default, ce qui signifie que les notifications de mise en quarantaine utilisent la langue par défaut du organization cloud.

Pour chaque langue que vous spécifiez, vous pouvez spécifier une valeur unique pour les paramètres MultiLanguageCustomDisclaimer et MultiLanguageSenderName. Veillez à aligner les valeurs des paramètres MultiLanguageSetting, MultiLanguageCustomDisclaimer et MultiLanguageSenderName correspondantes dans le même ordre.

Ce paramètre est disponible uniquement dans la stratégie de mise en quarantaine intégrée nommée DefaultGlobalTag qui contrôle les paramètres globaux. Pour accéder à cette stratégie de mise en quarantaine, démarrez votre commande avec la syntaxe suivante : Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ....

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

-OrganizationBrandingEnabled

Le paramètre OrganizationBrandingEnabled active ou désactive organization personnalisation dans les messages de notification de mise en quarantaine de l’utilisateur final. Les valeurs valides sont les suivantes :

  • $true : la personnalisation de l’organisation est activée. Le logo Microsoft par défaut utilisé dans les notifications de mise en quarantaine est remplacé par votre logo personnalisé. Avant de procéder, vous devez suivre les instructions fournies dans Personnaliser le thème Microsoft 365 pour votre organization charger votre logo personnalisé.
  • $false : la personnalisation de l’organisation est désactivée. Le logo Microsoft par défaut est utilisé dans les notifications de mise en quarantaine. Il s’agit de la valeur par défaut.

Ce paramètre est disponible uniquement dans la stratégie de mise en quarantaine intégrée nommée DefaultGlobalTag qui contrôle les paramètres globaux. Pour accéder à cette stratégie de mise en quarantaine, démarrez votre commande avec la syntaxe suivante : Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ....

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

-QuarantineRetentionDays

Ce paramètre est réservé à l’usage interne chez Microsoft.

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

-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, Exchange Online Protection