Set-SystemMessage
S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Dernière rubrique modifiée : 2007-09-05
La cmdlet Set-SystemMessage dans Microsoft Exchange Server 2007 permet de modifier des messages DSN (Delivery Status Notification) ou de quota personnalisés, dans la langue spécifiée, existants sur les ordinateurs sur lesquels le rôle serveur de transport Hub ou Edge est installé.
Syntaxe
Set-SystemMessage -Identity <SystemMessageIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Name <String>] [-Original <SwitchParameter>] [-Text <String>] [-WhatIf [<SwitchParameter>]]
Set-SystemMessage [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Instance <SystemMessage>] [-Name <String>] [-Original <SwitchParameter>] [-Text <String>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Cette cmdlet permet de modifier des messages DSN et de quota personnalisés. Des messages DSN sont envoyés à l'expéditeur de messages électroniques qui n'ont pas atteint leur destinataire. Des messages de quota sont adressés aux utilisateurs dont les boîtes aux lettres ou les dossiers publics ont atteint le quota spécifique d'avertissement, d'interdiction d'envoi ou d'interdiction de réception. Les messages DSN et de quota personnalisés remplacent les messages DSN ou de quota intégrés dans Exchange Server.
Note Le serveur Exchange est préconfiguré avec plusieurs messages DSN standard que vous ne pouvez pas modifier à l'aide de cette cmdlet. Au lieu de cela, vous devez créer un message DSN portant le même code DSN pour remplacer les messages préconfigurés.
La liste suivante décrit les conditions d'erreur qui déclenchent des messages DSN dont l'état de remise indique une défaillance temporaire persistante ou une défaillance permanente.
Messages DSN 4.X.X. Ce type de message DSN est généré en cas de problème temporaire avec la boîte aux lettres ou le serveur du destinataire. De tels problèmes se résolvent généralement spontanément, permettant la remise du message électronique. Un exemple de problème de défaillance temporaire persistante 4.X.X. est celui d'un serveur hors ligne devenu inaccessible.
Messages DSN 5.X.X. Ce type de message DSN est généré quand une erreur permanente ou irrécupérable se produit avec la boîte aux lettres ou le serveur du destinataire. Le serveur de messagerie expéditeur ne peut pas résoudre de telles erreurs, de sorte que le message électronique est retourné à l'expéditeur. Une défaillance permanente 5.X.X. est, par exemple, une adresse SMTP inexistante.
Pour exécuter la cmdlet Set-SystemMessage, vous devez utiliser un compte auquel a été délégué :
- le rôle Administrateur d'organisation Exchange.
Pour exécuter la cmdlet Set-SystemMessage sur un ordinateur sur lequel le rôle serveur de transport Edge est installé, vous devez ouvrir une session en utilisant un compte membre du groupe Administrateurs local sur cet ordinateur.
Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Exchange 2007, consultez la rubrique Considérations relatives aux autorisations.
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
Microsoft.Exchange.Configuration.Tasks.SystemMessageIdParameter |
Ce paramètre spécifie l'identité du message DSN ou de quota à modifier. Pour modifier un message DSN, utilisez le format suivant : language\internal | external\system code. Pour plus d'informations sur la syntaxe de l'identité du message de notification d'état de remise, consultez la rubrique Identité du message DSN. Pour modifier un message de quota personnalisé, utilisez le format suivant : language\QuotaMessageType. Language est exprimé comme un code local de deux caractères. Le paramètre QuotaMessageType accepte les valeurs suivantes :
Vous pouvez omettre le libellé du paramètre Identity. |
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 (FQDN) du contrôleur de domaine qui écrit des données 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 qui exécutent le rôle serveur de transport Edge. 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.SystemMessage |
Ce paramètre vous permet de transmettre le message DSN ou de quota à la commande à traiter. Il est utile dans les scripts où un objet entier doit être transmis à la commande. |
Name |
Facultatif |
System.String |
Ce paramètre spécifie un nom que vous pouvez utiliser pour décrire le message DSN ou de quota. |
Original |
Facultatif |
System.Management.Automation.SwitchParameter |
Ce paramètre rétablit la notification d'état de remise (DSN) ou le texte de message de quota au texte original expédié. Ce paramètre est utile lorsque vous ne voulez pas supprimer la notification d'état de remise personnalisée ou l'entrée de quota mais voulez rétablir le texte initial. |
Text |
Facultatif |
System.String |
Ce paramètre spécifie le texte du message affiché aux expéditeurs ou propriétaires de boîte aux lettres. Le texte doit expliquer pourquoi le message a été créé et les actions que l'expéditeur ou le propriétaire de la boîte aux lettres doit éventuellement exécuter. |
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. |
Types d'entrées
Types de retours
Erreurs
| Erreur | Description |
|---|---|
Exceptions
| Exceptions | Description |
|---|---|
Exemple
Dans l'exemple de code suivant, le premier exemple modifie le texte d'un message DSN personnalisé dont le code DSN est 5.3.5. Ce message DSN ne s'affiche que pour des utilisateurs externes. Le texte du message DSN est inclus dans la ligne de commande.
Le deuxième exemple modifie le texte anglais d'un message de quota WarningMailbox personnalisé existant.
Set-SystemMessage En\Internal\5.3.5 -Text "The recipient e-mail system can't process this e-mail message. Please contact your system administrator for more information."
Set-SystemMessage En\WarningMailbox -Text "Your mailbox has exceeded the warning limit specified by your e-mail administrator. Please reduce the size of your mailbox."