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.
Syntax
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>]
[-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 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
New-QuarantinePolicy -Name ContosoTag -EndUserQuarantinePermissionsValue 0Cet 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
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 (").
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-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 |
-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 $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: | 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.
Si vous n’utilisez pas ce paramètre, l’expéditeur par défaut est quarantine@messaging.microsoft.com.
| 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 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-MultiLanguageCustomDisclaimer
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 |
-MultiLanguageSenderName
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 |
-MultiLanguageSetting
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 |
-Name
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 (").
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-OrganizationBrandingEnabled
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 |
-QuarantinePolicyType
Ce paramètre est réservé à l’usage interne chez Microsoft.
| Type: | QuarantinePolicyType |
| Accepted values: | QuarantinePolicy, GlobalQuarantinePolicy |
| 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 |