New-QuarantinePolicy
Cette cmdlet est disponible uniquement dans le service cloud.
Utilisez l’applet de commande New-QuarantinePolicy pour créer des 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.
Syntaxe
Default (Par défaut)
New-QuarantinePolicy
[-Name] <String>
[-AdminDisplayName <String>]
[-AdminNotificationFrequencyInDays <Int32>]
[-AdminNotificationLanguage <EsnLanguage>]
[-AdminNotificationsEnabled <Boolean>]
[-AdminQuarantinePermissionsList <MultiValuedProperty>]
[-CustomDisclaimer <String>]
[-DomainController <Fqdn>]
[-EndUserQuarantinePermissions <QuarantinePermissions>]
[-EndUserQuarantinePermissionsValue <Int32>]
[-EndUserSpamNotificationCustomFromAddress <String>]
[-EndUserSpamNotificationFrequency <TimeSpan>]
[-EndUserSpamNotificationFrequencyInDays <Int32>]
[-EndUserSpamNotificationLanguage <EsnLanguage>]
[-EsnCustomSubject <MultiValuedProperty>]
[-ESNEnabled <Boolean>]
[-IncludeMessagesFromBlockedSenderAddress <Boolean>]
[-MultiLanguageCustomDisclaimer <MultiValuedProperty>]
[-MultiLanguageSenderName <MultiValuedProperty>]
[-MultiLanguageSetting <MultiValuedProperty>]
[-OrganizationBrandingEnabled <Boolean>]
[-QuarantinePolicyType <QuarantinePolicyType>]
[-QuarantineRetentionDays <Int32>]
[<CommonParameters>]
Description
Les stratégies de mise en quarantaine définissent ce que les utilisateurs sont autorisés à faire pour les messages mis en quarantaine en fonction de la raison pour laquelle le message a été mis en quarantaine (pour les fonctionnalités prises en charge) et des paramètres de notification de mise en quarantaine. Pour plus d’informations, voir Stratégies de mise en quarantaine.
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-QuarantinePolicy -Name ContosoTag -EndUserQuarantinePermissionsValue 0
Cet exemple crée une stratégie de mise en quarantaine nommée ContosoTag avec les mêmes autorisations que le groupe d’autorisations prédéfinies Sans accès.
Pour attribuer des autorisations d’accès limité, utilisez la valeur 27. Pour attribuer des autorisations d’accès complet, utilisez la valeur 23.
Paramètres
-AdminDisplayName
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le paramètre AdminDisplayName spécifie une description de la stratégie de mise en quarantaine. 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 |
-AdminNotificationFrequencyInDays
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Ce paramètre est réservé à l’usage interne chez Microsoft.
Propriétés du paramètre
| Type: | Int32 |
| 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 |
-AdminNotificationLanguage
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Ce paramètre est réservé à l’usage interne chez Microsoft.
Propriétés du paramètre
| Type: | EsnLanguage |
| Valeur par défaut: | None |
| Valeurs acceptées: | 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 |
| 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 |
-AdminNotificationsEnabled
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Ce paramètre est réservé à l’usage interne chez Microsoft.
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 |
-AdminQuarantinePermissionsList
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Ce paramètre est réservé à l’usage interne chez Microsoft.
Propriétés du paramètre
| Type: | MultiValuedProperty |
| 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 |
-CustomDisclaimer
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Ce paramètre est réservé à l’usage interne chez Microsoft.
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 |
-DomainController
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Ce paramètre est réservé à l’usage interne chez Microsoft.
Propriétés du paramètre
| Type: | Fqdn |
| 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 |
-EndUserQuarantinePermissions
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Remarque : Pour définir des autorisations dans les stratégies de quarantaine, nous vous recommandons d’utiliser le paramètre EndUserQuarantinePermissionsValue.
EndUserQuarantinePermissions spécifie les autorisations de l’utilisateur final pour la stratégie de mise en quarantaine à l’aide d’une variable provenant de la sortie d’une commande New-QuarantinePermissions ou Set-QuarantinePermissions.
Par exemple, exécutez la commande suivante pour stocker les autorisations requises dans une variable : $Perms = New-QuarantinePermissions <permissions>. Dans la même session PowerShell, utilisez la valeur $Perms de ce paramètre.
Propriétés du paramètre
| Type: | QuarantinePermissions |
| 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 |
-EndUserQuarantinePermissionsValue
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
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
- 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 = 00101011. Utilisez donc la valeur décimale 43.
- Accès complet : Binaire = 00100111. Utilisez donc la valeur décimale 39.
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.
Propriétés du paramètre
| Type: | Int32 |
| 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 |
-EndUserSpamNotificationCustomFromAddress
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
EndUserSpamNotificationCustomFromAddress spécifie l’adresse e-mail d’un expéditeur interne existant à utiliser comme expéditeur pour les notifications de mise en quarantaine.
Si vous n’utilisez pas ce paramètre, l’expéditeur par défaut est quarantine@messaging.microsoft.com.
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 |
-EndUserSpamNotificationFrequency
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le paramètre EndUserSpamNotificationFrequency spécifie la fréquence à laquelle les notifications de mise en 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)
Propriétés du paramètre
| Type: | TimeSpan |
| 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 |
-EndUserSpamNotificationFrequencyInDays
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Ce paramètre est réservé à l’usage interne chez Microsoft.
Propriétés du paramètre
| Type: | Int32 |
| 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 |
-EndUserSpamNotificationLanguage
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Ce paramètre est réservé à l’usage interne chez Microsoft.
Propriétés du paramètre
| Type: | EsnLanguage |
| Valeur par défaut: | None |
| Valeurs acceptées: | 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 |
| 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 |
-EsnCustomSubject
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
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 ....
Propriétés du paramètre
| Type: | MultiValuedProperty |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | MultiValuedProperty |
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 |
-ESNEnabled
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
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. Cette valeur est 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 où toutes les autorisations sont désactivées), les utilisateurs peuvent voir leurs messages en quarantaine, mais la seule action disponible pour les messages est Afficher l’en-tête du message.
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 |
-IncludeMessagesFromBlockedSenderAddress
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le paramètre IncludeMessagesFromBlockedSenderAddress spécifie s’il faut envoyer des notifications de mise en quarantaine pour les messages mis en quarantaine à partir d’adresses d’expéditeur bloquées. Les valeurs valides sont les suivantes :
- $true : les destinataires reçoivent des notifications de mise en quarantaine pour les messages affectés provenant d’expéditeurs bloqués.
- $false : les destinataires ne reçoivent pas de notifications de mise en quarantaine pour les messages affectés provenant d’expéditeurs bloqués. Cette valeur est la valeur par défaut.
Propriétés du paramètre
| Type: | Boolean |
| Valeur par défaut: | False |
| 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 |
-MultiLanguageCustomDisclaimer
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Ce paramètre est réservé à l’usage interne chez Microsoft.
Propriétés du paramètre
| Type: | MultiValuedProperty |
| 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 |
-MultiLanguageSenderName
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Ce paramètre est réservé à l’usage interne chez Microsoft.
Propriétés du paramètre
| Type: | MultiValuedProperty |
| 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 |
-MultiLanguageSetting
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Ce paramètre est réservé à l’usage interne chez Microsoft.
Propriétés du paramètre
| Type: | MultiValuedProperty |
| 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, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le paramètre Name spécifie un nom unique pour la stratégie de mise en quarantaine. 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: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-OrganizationBrandingEnabled
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Ce paramètre est réservé à l’usage interne chez Microsoft.
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 |
-QuarantinePolicyType
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Ce paramètre est réservé à l’usage interne chez Microsoft.
Propriétés du paramètre
| Type: | QuarantinePolicyType |
| Valeur par défaut: | None |
| Valeurs acceptées: | QuarantinePolicy, GlobalQuarantinePolicy |
| 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 |
-QuarantineRetentionDays
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Ce paramètre est réservé à l’usage interne chez Microsoft.
Propriétés du paramètre
| Type: | Int32 |
| 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 |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.