New-SystemMessage
S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Dernière rubrique modifiée : 2007-07-27
La cmdlet New-SystemMessage dans Microsoft Exchange Server 2007 permet de créer des messages personnalisés de DSN (Delivery Status Notification) ou de quota, dans la langue spécifiée, sur les ordinateurs sur lesquels le rôle serveur de transport Hub ou Edge est installé.
Syntaxe
New-SystemMessage -DsnCode <EnhancedStatusCode> -Internal <$true | $false> -Language <CultureInfo> -Text <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]
New-SystemMessage -Language <CultureInfo> -QuotaMessageType <WarningMailboxUnlimitedSize | WarningPublicFolderUnlimitedSize | WarningMailbox | WarningPublicFolder | ProhibitSendMailbox | ProhibitPostPublicFolder | ProhibitSendReceiveMailBox> -Text <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Cette cmdlet permet de créer des messages personnalisés de DSN et de quota. 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.
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 New-SystemMessage, vous devez utiliser un compte auquel a été délégué :
- le rôle Administrateur d'organisation Exchange.
Pour exécuter la cmdlet New-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 |
|---|---|---|---|
DsnCode |
Obligatoire |
Microsoft.Exchange.Data.EnhancedStatusCode |
Ce paramètre spécifie le code DSN auquel s'applique le message DSN. Ce paramètre peut être un code intégré ou un code personnalisé défini par l'administrateur. > [!Note] > Ce paramètre n'est pas obligatoire et ne peut pas être utilisé lorsque le paramètre QuotaMessageType est spécifié. |
Internal |
Obligatoire |
System.Boolean |
Ce paramètre spécifie si le message s'affiche pour les utilisateurs se trouvant à l'intérieur de l'organisation Exchange Server. Pour les messages qui ne s'affichent qu'au niveau interne, entrez |
Language |
Obligatoire |
System.Globalization.CultureInfo |
Ce paramètre spécifie la langue du message. Le message peut être créé dans toute langue prise en charge par Exchange Server. Les langues sont spécifiées à l'aide du nom qui leur est attribué dans les paramètres régionaux. Par exemple, le français est identifié par « fr » et je japonais par « ja ». Pour obtenir la liste complète des paramètres régionaux, consultez la rubrique Paramètres régionaux pris en charge pour utilisation avec des messages système. |
QuotaMessageType |
Obligatoire |
Microsoft.Exchange.Data.Directory.SystemConfiguration.QuotaMessageType |
Ce paramètre sélectionne le type de message de quota à créer. Le paramètre QuotaMessageType accepte les valeurs suivantes :
|
Text |
Obligatoire |
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. |
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 extrait des données du 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). |
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 ajoute 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, avec la langue du message, à savoir l'anglais.
Le deuxième exemple ajoute un message de quota WarningMailbox personnalisé. Ce message s'affiche aux utilisateurs réunissant les critères suivants :
Le contenu de la boîte aux lettres a dépassé la limite d'avertissement configurée.
Aucun quota d'interdiction d'expédition ou de réception de boîte aux lettres n'est configuré.
La boîte aux lettres se situe sur un serveur utilisant les paramètres régionaux anglais.
New-SystemMessage -DsnCode 5.3.5 -Language En -Internal $false -Text "The recipient e-mail system can't process this e-mail message. Please contact your system administrator for more information."
New-SystemMessage -QuotaMessageType WarningMailbox -Language En -Text "Your mailbox has exceeded the warning limit specified by your e-mail administrator. Please reduce the size of your mailbox."