New-MessageClassification
Cette cmdlet est disponible dans Exchange sur site et dans le service cloud. Certains paramètres peuvent être propres à un environnement ou à un autre.
La cmdlet New-MessageClassification permet de créer une instance de classification de message dans votre organisation.
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-MessageClassification
[-Name] <String>
-DisplayName <String>
-Locale <CultureInfo>
-SenderDescription <String>
[-Confirm]
[-DomainController <Fqdn>]
[-RecipientDescription <String>]
[-WhatIf]
[<CommonParameters>]
New-MessageClassification
[-Name] <String>
-DisplayName <String>
-SenderDescription <String>
[-ClassificationID <Guid>]
[-Confirm]
[-DisplayPrecedence <ClassificationDisplayPrecedenceLevel>]
[-DomainController <Fqdn>]
[-PermissionMenuVisible <Boolean>]
[-RecipientDescription <String>]
[-RetainClassificationEnabled <Boolean>]
[-WhatIf]
[<CommonParameters>]
Description
Après avoir créé une classification de message, vous pouvez la définir comme un prédicat de règle de transport. Avant Microsoft Outlook et Outlook sur le web utilisateurs puissent appliquer la classification des messages aux messages, vous devez mettre à jour les systèmes des utilisateurs finaux avec le fichier XML de classification des messages créé par le fichier de script Export-OutlookClassification.ps1. Le fichier de script Export-OutlookClassification.ps1 se trouve dans le répertoire %ExchangeInstallPath%Scripts.
Lorsque vous créez une classification de message, elle ne possède pas de 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.
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-MessageClassification -Name "My Message Classification" -DisplayName "New Message Classification" -SenderDescription "This is the description text"
Cet exemple crée la classification de messages nommée My Message Classification avec les propriétés suivantes :
- Le nom complet est New Message Classification.
- La description de l'expéditeur est « This is the description text ».
Exemple 2
New-MessageClassification -Name "My Message Classification" -Locale es-ES -DisplayName "España Example" -SenderDescription "Este es el texto de la descripción"
Dans Exchange local, cet exemple crée une version propre aux paramètres régionaux (Espagnol - Espagne) d’une classification de messages existante nommée « My Message Classification ».
Paramètres
-ClassificationID
Le paramètre ClassificationID spécifie l’ID de classification (GUID) d’une classification de messages existante que vous souhaitez importer et utiliser dans votre organisation Exchange. Utilisez ce paramètre si vous configurez des classifications de messages qui s’étendent sur deux forêts Exchange dans la même organisation.
Pour rechercher la valeur ClassificationID de la classification des messages, remplacez par <MessageClassificationName>
le nom de la classification des messages et exécutez la commande suivante : Get-MessageClassification -Identity "<MessageClassificationName>"
.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Confirm
Le commutateur Confirme 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 applets de commande destructrices (par exemple, les applets de commande Remove-*) ont une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte :
-Confirm:$false
. - La plupart des autres applets de commande (par exemple, les applets de commande 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.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DisplayName
Le paramètre DisplayName spécifie le titre de la classification des messages affichée dans Outlook et sélectionnée par les utilisateurs. La longueur maximale est de 256 caractères. Si la valeur contient des espaces, placez-la entre guillemets (").
Le fichier XML de classification de message doit figurer sur l'ordinateur de l'expéditeur pour que le nom complet s'affiche.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DisplayPrecedence
Le paramètre DisplayPrecedence indique la priorité relative de la classification de message sur d’autres classifications de message éventuellement appliquées à un message spécifié. Les valeurs valides sont les suivantes :
- La plus élevée
- Plus élevée
- Élevé
- MediumHigh
- Moyen (il s’agit de la valeur par défaut)
- MediumLow
- Faible
- Inférieur
- La plus faible
Bien qu’Outlook ne permette à un utilisateur de spécifier qu’une seule classification pour un message, les règles de transport peuvent appliquer d’autres classifications à un message. La classification avec la priorité la plus élevée est affichée en premier et les classifications suivantes, qui sont celles qui ont une priorité inférieure, telles que définies par ce paramètre, sont ajoutées dans l’ordre approprié par la suite.
Type: | ClassificationDisplayPrecedenceLevel |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DomainController
Ce paramètre est disponible uniquement dans Exchange 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 ».
Les serveurs de transport Edge ne prennent pas en charge le paramètre DomainController. Un serveur de transport Edge utilise l’instance locale des services AD LDS (Active Directory Lightweight Directory Services) pour lire et écrire des données.
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Locale
Ce paramètre est fonctionnel sur dans Exchange local.
Le paramètre Paramètres régionaux spécifie une version propre aux paramètres régionaux d’une classification de messages existante. Vous utilisez le paramètre -Name pour identifier la classification des messages existante et le paramètre SenderDescription pour spécifier le texte descriptif dans une autre langue.
Une valeur valide pour ce paramètre est une valeur de code de culture prise en charge à partir de la classe CultureInfo Microsoft .NET Framework (par exemple, da-DK pour le danois ou ja-JP pour le japonais). Pour plus d’informations, consultez CultureInfo, classe.
Type: | CultureInfo |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Name
Le paramètre Name spécifie le nom unique de la classification des messages. La longueur maximale est de 64 caractères. Si la valeur contient des espaces, placez-la entre guillemets (").
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-PermissionMenuVisible
Le paramètre PermissionMenuVisible spécifie si les valeurs que vous avez entrées pour les paramètres DisplayName et RecipientDescription sont affichées dans Outlook à mesure que l’utilisateur compose un message. Les valeurs valides sont les suivantes :
- $true : les utilisateurs peuvent affecter la classification des messages aux messages avant qu’ils ne soient envoyés, et les informations de classification s’affichent. Il s’agit de la valeur par défaut.
- $false : les utilisateurs ne peuvent pas affecter la classification des messages aux messages avant leur envoi. Toutefois, les messages reçus avec cette classification de messages affichent toujours les informations de classification.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-RecipientDescription
Le paramètre RecipientDescription spécifie le texte détaillé affiché au destinataire Outlook lorsqu’il reçoit un message auquel la classification des messages est appliquée. La longueur maximale est de 1 024 caractères. Si la valeur contient des espaces, placez-la entre guillemets (").
Si vous n’utilisez pas ce paramètre, la valeur du paramètre SenderDescription est utilisée.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-RetainClassificationEnabled
Le paramètre RetainClassificationEnabled spécifie 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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SenderDescription
Le paramètre SenderDescription spécifie le texte détaillé affiché aux expéditeurs Outlook lorsqu’ils sélectionnent une classification de message à appliquer à un message avant d’envoyer le message. La longueur maximale est de 1 024 caractères. Si la valeur contient des espaces, placez-la entre guillemets (").
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-WhatIf
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.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
Entrées
Input types
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.
Sorties
Output types
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.