Set-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 Set-MessageClassification permet de configurer une instance de classification de message existante dans votre organisation Exchange.

Syntaxe

Set-MessageClassification -Identity <MessageClassificationIdParameter> [-ClassificationID <Guid>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayPrecedence <Highest | Higher | High | MediumHigh | Medium | MediumLow | Low | Lower | Lowest>] [-DomainController <Fqdn>] [-Name <String>] [-RecipientDescription <String>] [-RetainClassificationEnabled <$true | $false>] [-SenderDescription <String>] [-UserDisplayEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]

Set-MessageClassification [-ClassificationID <Guid>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayPrecedence <Highest | Higher | High | MediumHigh | Medium | MediumLow | Low | Lower | Lowest>] [-DomainController <Fqdn>] [-Instance <MessageClassification>] [-Name <String>] [-RecipientDescription <String>] [-RetainClassificationEnabled <$true | $false>] [-SenderDescription <String>] [-UserDisplayEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Pour exécuter la cmdlet Set-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
Identity	Obligatoire	Microsoft.Exchange.Configuration.Tasks.MessageClassificationIdParameter	Le paramètre Identity peut prendre la valeur d'une chaîne, qui est la valeur de Name, ou le GUID.
ClassificationID	Facultatif	System.Guid	Ce paramètre permet de spécifier un GUID d'une classification de message existante que vous voulez 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 organisation.
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.
DisplayName	Facultatif	System.String	Ce paramètre permet de spécifier le nom complet de l'instance de classification de message. Le nom complet apparaît dans Microsoft Office 2007 et est utilisé par les utilisateurs de Microsoft Outlook pour sélectionner la classification de message appropriée avant d'envoyer un message. 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.
DisplayPrecedence	Facultatif	Microsoft.Exchange.Data.Directory.SystemConfiguration.ClassificationDisplayPrecedenceLevel	Ce paramètre permet de spécifier la priorité relative de la classification de message sur d'autres classifications de message éventuellement appliquées à un message donné. Bien qu'Outlook ne permette à un utilisateur de spécifier qu'une seule classification sur un message donné, les règles de transport peuvent appliquer d'autres classifications. Ce paramètre définit la priorité dans une classification donnée concernant ce qui s'affiche au destinataire dans Outlook. La classification dont la priorité est la plus élevée s'affiche en premier lieu, puis les classifications suivantes, qui sont de moindre priorité en vertu de la définition de ce paramètre, sont ajoutées dans l'ordre approprié. Une entrée valide pour le paramètre DisplayPrecedence est Highest, Higher, High, MediumHigh, Medium, MediumLow, Low, Lower ou Lowest. La valeur par défaut est Mediuum.
DomainController	Facultatif	Microsoft.Exchange.Data.Fqdn	Pour spécifier le nom de domaine complet (FQDN) 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).
Instance	Facultatif	Microsoft.Exchange.Data.Directory.SystemConfiguration.MessageClassification	Ce paramètre permet de transmettre un objet entier à la commande à traiter. Il est principalement utilisé dans les scripts où un objet entier doit être transmis à la commande.
Name	Facultatif	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.
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.
RetainClassificationEnabled	Facultatif	System.Boolean	Ce paramètre permet de spécifier si la classification de message doit persister avec le message s'il fait l'objet d'un transfert ou d'une réponse. La valeur par défaut est $true.
SenderDescription	Facultatif	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.
UserDisplayEnabled	Facultatif	System.Boolean	Lorsque le paramètre UserDisplayEnabled est défini sur $true, il affiche le texte que vous avez entré dans les paramètres DisplayName et RecipientDescription pour le destinataire des messages envoyés avec cette classification. La valeur par défaut est $true.
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 définit l'action de confidentialité sur « None » et la priorité d'affichage sur « false » pour l'instance de classification de message dont le paramètre Identity a la valeur « Example ». Il spécifie également que la classification de message doit persister avec le message si celui-ci fait l'objet d'un transfert ou d'une réponse.

Set-MessageClassification -Identity Example -ConfidentialityAction None -DisplayPrecedence -RetainClassificationEnabled: $false