New-MessageClassification

  • Article

 

S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Dernière rubrique modifiée : 2007-06-28

La cmdlet New-MessageClassification permet de créer une instance de classification de message dans votre organisation Exchange. Après avoir créé une classification de message, vous pouvez la définir comme un prédicat de règle de transport. Pour que des utilisateurs de Microsoft Office Outlook 2007 et Outlook Web Access 2007 puissent appliquer la classification de message à des messages, vous devez mettre à jour les systèmes d'utilisateur final avec le fichier XML de classification de message créé par le fichier script Export-OutlookClassification.ps1. Le fichier script Export-OutlookClassification.ps1 se trouve dans le répertoire \Program Files\Microsoft\Exchange Server\Scripts.

Une nouvelle classification de message n'est pas associée à des paramètres régionaux. Par défaut, la nouvelle classification de message est utilisée pour tous les paramètres régionaux. Après avoir défini une classification de message par défaut, vous pouvez ajouter des paramètres régionaux de la classification en exécutant la cmdlet New-MessageClassification et en spécifiant l'identité de classification de message par défaut que vous voulez localiser.

Syntaxe

New-MessageClassification -Name <String> -DisplayName <String> -SenderDescription <String> [-ClassificationID <Guid>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-RecipientDescription <String>] [-TemplateInstance <PSObject>] [-UserDisplayEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]

New-MessageClassification -Identity <MessageClassificationIdParameter> -Locale <CultureInfo> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-RecipientDescription <String>] [-SenderDescription <String>] [-TemplateInstance <PSObject>] [-UserDisplayEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Pour exécuter la cmdlet New-MessageClassification, vous devez utiliser un compte auquel a été délégué :

  • le rôle Administrateur d'organisation Exchange.

Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Microsoft Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.

Paramètres

Paramètre Obligatoire Type Description

DisplayName

Obligatoire

System.String

Le paramètre DisplayName permet de spécifier le nom complet de l'instance de classification de message. Le nom complet apparaît dans Office 2007 et est utilisé par les utilisateurs d'Outlook pour sélectionner la classification de message appropriée avant d'envoyer un message.

> [!Note] > Le fichier XML de classification de message doit figurer sur l'ordinateur de l'expéditeur pour que le nom complet s'affiche.

Si le paramètre UserDisplayEnabled est défini sur $true, le nom complet s'affiche pour le destinataire, même si aucun fichier XML de classification de message n'est installé.

Si vous entrez un nom contenant des espaces, vous devez placer le nom entre guillemets, comme suit, "Display Name". Le paramètre DisplayName peut contenir jusqu'à 64 caractères.

Identity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.MessageClassificationIdParameter

Ce paramètre permet de créer une version traduite d'une classification de message existante. Vous devez également spécifier le paramètre Locale. Le paramètre Identity peut prendre la valeur d'une chaîne, qui est la valeur Name d'une classification de message existante.

Locale

Obligatoire

System.Globalization.CultureInfo

La spécification d'un code de culture pour le paramètre Locale crée une version spécifique aux paramètres régionaux de la classification de message. Vous devez également transmettre le paramètre Identity de la classification de message existante par défaut lors de la création d'une version spécifique aux paramètres régionaux.

Une entrée valide pour le paramètre Locale est l'un des noms de chaîne répertoriés dans la colonne Nom de culture dans la référence de classe de bibliothèque de classes Microsoft .NET disponible dans la page CultureInfo.

Name

Obligatoire

System.String

Ce paramètre permet de spécifier le nom administratif de l'instance de classification de message. Ce nom est utilisé pour administrer l'instance de classification de message. Si vous entrez un nom contenant des espaces, vous devez placer le nom entre guillemets, comme suit, "Adminstrative Name". Le paramètre Name peut contenir jusqu'à 256 caractères.

SenderDescription

Obligatoire

System.String

Ce paramètre permet d'expliquer à l'expéditeur le but de la classification de message. Le texte que vous entrez dans ce paramètre est utilisé par les utilisateurs d'Outlook pour sélectionner la classification de message appropriée avant d'envoyer un message. Insérez la description entre guillemets, comme suit, "This is the sender description that explains when to use this message classification". Le paramètre SenderDescription peut contenir jusqu'à 1 024 caractères.

ClassificationID

Facultatif

System.Guid

Ce paramètre permet de spécifier un ID de classification d'une classification de message existante que vous voulez importer et utiliser dans votre organisation Exchange. Utilisez ce paramètre si vous configurez des classifications de message pour deux forêts Exchange au sein de la même entreprise.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre Confirm suspend le traitement par la commande et vous demande de confirmer les actions que la commande va exécuter avant de continuer le traitement. Il n'est pas nécessaire de spécifier une valeur pour le paramètre Confirm.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Pour spécifier le nom de domaine complet du contrôleur de domaine qui écrit ce changement de configuration dans le service d'annuaire Active Directory, incluez le paramètre DomainController dans la commande. Le paramètre DomainController n'est pas pris en charge sur les ordinateurs sur lesquels le rôle serveur de transport Edge est installé. Le rôle serveur de transport Edge écrit et lit uniquement sur l'instance locale Active Directory Application Mode (ADAM).

RecipientDescription

Facultatif

System.String

Ce paramètre permet d'expliquer au destinataire le but de la classification de message. Le texte que vous entrez dans ce paramètre est consulté par les utilisateurs d'Outlook lorsqu'ils reçoivent un message ayant cette classification. Insérez la description entre guillemets, comme suit, "This is the recipient description that explains how to treat the message that has been classified". Le paramètre RecipientDescription peut contenir jusqu'à 1 024 caractères.

Si vous n'entrez pas de valeur pour ce paramètre, la description que vous entrez pour SenderDescription est utilisée.

TemplateInstance

Facultatif

System.Management.Automation.PSObject

Lorsqu'un objet existant est fourni pour le paramètre TemplateInstance, la commande utilise la configuration de l'objet pour créer une copie de celui-ci sur un serveur local ou cible.

UserDisplayEnabled

Facultatif

System.Boolean

Ce paramètre permet de spécifier si les valeurs que vous avez entrées pour les paramètres DisplayName et RecipientDescription s'affichent dans le message Outlook du destinataire.

Si vous définissez le paramètre UserDisplayEnabled sur $false, les messages envoyés aux destinataires qui ont cette classification de message n'affichent pas d'informations de classification.

La valeur par défaut est $true.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre Confirm suspend le traitement par la commande et vous demande de confirmer les actions que la commande va exécuter avant de continuer le traitement. Il n'est pas nécessaire de spécifier une valeur pour le paramètre Confirm.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre WhatIf donne pour instruction à la commande de simuler les actions qu'elle va appliquer à l'objet. Grâce au paramètre WhatIf, vous pouvez afficher des changements potentiels sans devoir les appliquer. Il n'est pas nécessaire de spécifier une valeur pour le paramètre WhatIf.

Exemple

L'exemple de code suivant présente trois exemples utilisant la cmdlet New-MessageClassification.

Le premier exemple montre la commande New-MessageClassification qui a les paramètres requis.

Le deuxième exemple montre comment créer une version spécifique à des paramètres régionaux (Spanish - Spain) d'une classification de message existante.

Le troisième exemple montre comment créer une autre version spécifique à des paramètres régionaux (Spanish - Mexico) d'une classification de message existante.

New-MessageClassification -Name Example -DisplayName "New Message Classification" -SenderDescription "This is the description text"
New-MessageClassification -Identity Example -Locale es-ES -DisplayName "España Example " -SenderDescription "Este es el texto de la descripción"
New-MessageClassification -Identity Example -Locale es-MX -DisplayName "México Example" -SenderDescription "Este es el texto de la descripción"