New-OutlookProtectionRule

 

S’applique à :Exchange Online, Exchange Server 2016

Dernière rubrique modifiée :2016-03-31

Cette cmdlet est disponible dans Exchange Server 2016 sur site et dans le service en nuage. Certains paramètres peuvent être propres à un environnement ou à un autre.

La cmdlet New-OutlookProtectionRule permet de créer une règle de protection Microsoft Outlook.

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

New-OutlookProtectionRule -ApplyRightsProtectionTemplate <RmsTemplateIdParameter> -Name <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-FromDepartment <String[]>] [-Priority <Int32>] [-SentTo <RecipientIdParameter[]>] [-SentToScope <All | InOrganization>] [-UserCanOverride <$true | $false>] [-WhatIf [<SwitchParameter>]]

Cet exemple applique le modèle AD RMS Template-Contoso aux messages envoyés à l’adresse SMTP Joe@contoso.com.

New-OutlookProtectionRule -Name "Project Contoso" -SentTo Joe@contoso.com -ApplyRightsProtectionTemplate "Template-Contoso"

Les règles de protection Outlook sont des règles créées par l’administrateur et sont appliquées avant qu’un utilisateur envoie un message à l’aide d’Outlook. Outlook inspecte le contenu du message et protège les messages en appliquant des modèles de droits Active Directory Rights Management Services (AD RMS).

Pour plus d’informations, voir Règles de protection Outlook.

CautionAttention :
Les règles de protection Outlook créées sans conditions s’appliquent à tous les messages.

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que tous les paramètres de cette cmdlet soient répertoriés dans cette rubrique, 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 voir les autorisations qui vous sont nécessaires, voir l’entrée « Configuration de la gestion des droits relatifs à l’information (IRM) » dans la rubrique Stratégie de messagerie et autorisations de conformité dans Exchange 2016.

 

Paramètre Obligatoire Type Description

ApplyRightsProtectionTemplate

Obligatoire

Microsoft.Exchange.Configuration.Tasks.RmsTemplateIdParameter

Le paramètre ApplyRightsProtectionTemplate spécifie le modèle AD RMS à appliquer au message. Il suffit d’utiliser le nom du modèle AD RMS pour le spécifier. Utilisez la cmdlet Get-RMSTemplate pour récupérer des modèles de votre serveur AD RMS.

Name

Requis

System.String

Le paramètre Name spécifie un nom pour la règle.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur Confirm 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 cmdlets destructives (par exemple, les cmdlets Remove-*) ont une pause intégrée qui vous oblige à confirmer la commande avant de poursuivre. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.

  • La plupart des autres cmdlets (par exemple, les cmdlets 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.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Ce paramètre est disponible uniquement dans Exchange 2016 sur site.

Le paramètre DomainController spécifie le contrôleur de domaine qui est utilisé par cette cmdlet pour lire ou écrire les données dans Active Directory. Vous identifiez le contrôleur de domaine par son nom de domaine complet (FQDN). Par exemple : dc01.contoso.com.

Enabled

Facultatif

System.Boolean

Le paramètre Enabled indique si les règles de protection Outlook sont activées. Les nouvelles règles de protection Outlook sont activées par défaut. Pour créer une règle sans l’activer, définissez le paramètre Enabled sur $false.

Force

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur Force indique si le message de confirmation utilisé pour avertir l’administrateur doit être supprimé lorsque des règles sont créés sans conditions. Les règles sans conditions spécifiées s’appliquent à tous les messages. Le commutateur Force ne nécessite aucune valeur.

FromDepartment

Facultatif

System.String[]

Le paramètre FromDepartment spécifie le service de l’expéditeur comme condition. La propriété du service de l’utilisateur est comparée à la valeur spécifiée.

Priority

Facultatif

System.Int32

Le paramètre Priority indique si l’ordre de traitement des règles de protection Outlook doit être défini. Les règles avec une valeur de priorité plus faible sont exécutées en premier.

SentTo

Facultatif

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

Le paramètre SentTo spécifie un ou plusieurs destinataires comme condition de règle. Vous pouvez spécifier l’identité des destinataires dans l’organisation ou l’adresse SMTP des destinataires externes.

Le paramètre SentTo n’accepte pas les caractères génériques. Lorsque plusieurs destinataires sont spécifiés, les messages envoyés à certains de ces destinataires constituent une correspondance.

SentToScope

Facultatif

Microsoft.Exchange.Management.OutlookProtectionRules.ToUserScope

Le paramètre SentToScope spécifie la portée du message comme condition. Vous pouvez utiliser l’une des valeurs suivantes :

  • InOrganization   Cette valeur est destinée aux messages envoyés aux destinataires dans l’organisation.

  • All   Cette valeur est destinée aux messages envoyés à tous les destinataires.

UserCanOverride

Facultatif

System.Boolean

Le paramètre UserCanOverride spécifie si les utilisateurs peuvent remplacer des actions prises par des règles de protection Outlook. Par défaut, les utilisateurs peuvent remplacer des actions prises par les règles de protection Outlook. Lorsqu’il est défini sur $false, le paramètre UserCanOverride empêche l’utilisateur d’annuler la règle lors de l’envoi du message.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

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.

Pour visualiser les types d’entrées acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. Si le champ Type d’entrée pour une cmdlet est vide, la cmdlet n’accepte pas les données d’entrée.

Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.

 
Afficher: