New-MessageClassification
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 Si vous entrez un nom contenant des espaces, vous devez placer le nom entre guillemets, comme suit, |
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, |
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, |
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, 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 La valeur par défaut est |
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"