Set-SystemMessage
La cmdlet est disponible uniquement dans Exchange en local.
Utilisez l’applet de commande Set-SystemMessage pour modifier les messages système personnalisés. Les messages système sont des notifications d’état de remise (également appelés messages DSN, de remise, d’échec ou de non-remise) et des messages de quota.
Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.
Syntax
Set-SystemMessage
[-Identity] <SystemMessageIdParameter>
[-Confirm]
[-DomainController <Fqdn>]
[-Name <String>]
[-Original]
[-Text <String>]
[-WhatIf]
[<CommonParameters>]
Description
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
Set-SystemMessage En\Internal\5.3.5 -Text "The recipient email system can't process this email message. Please contact your system administrator for more information."
Cet exemple modifie le texte du message système anglais personnalisé pour le code d’état amélioré 5.3.5 pour les expéditeurs internes.
Exemple 2
Set-SystemMessage En\WarningMailbox -Text "Your mailbox has exceeded the warning limit specified by your email administrator. Please reduce the size of your mailbox."
Cet exemple montre comment modifier le texte du message de quota WarningMailbox en anglais personnalisé.
Paramètres
-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 |
-DomainController
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 |
-Identity
Le paramètre Identity spécifie le message système personnalisé que vous souhaitez modifier. Vous pouvez utiliser n’importe quelle valeur permettant d’identifier le message système de manière unique. Par exemple :
- Identité
- Nom unique (DN)
- GUID
La valeur de l’identité d’un message système utilise l’un des formats suivants :
- Messages système pour les codes d’état améliorés :
Language\<Internal | External>\DSNCode
. Par exemple :En\Internal\5.1.2
ouJa\External\5.1.2
. - Messages système pour les quotas :
Language\QuotaMessageType
. Par exemple :En\ProhibitSendReceiveMailbox
.
<Langue> : pour obtenir la liste des codes de langue pris en charge, consultez Langues prises en charge pour les NDR.
<DSNCode> : les valeurs valides sont 4.x.y ou 5.x.y, où x et y sont des nombres de un à trois chiffres. Pour afficher les codes système améliorés actuellement utilisés par les messages système personnalisés, exécutez la commande Get-SystemMessage
. Pour générer la liste des codes d’état améliorés par défaut utilisés par Exchange, exécutez la commande suivante : Get-SystemMessage -Original | Select-Object -Property Identity,DsnCode,Language,Text | ConvertTo-Html | Set-Content -Path "C:\My Documents\Default DSNs.html"
.
<QuotaMessageType> : les valeurs valides sont les suivantes :
Vous pouvez spécifier plusieurs critères à l'aide de l'opérateur de comparaison and. Les valeurs de propriété qui ne sont pas exprimées sous la forme d'un nombre entier doivent être entrées entre guillemets (« »).
- ProhibitSendReceiveMailbox : une boîte aux lettres dépasse sa limite ProhibitSendReceiveQuota.
- ProhibitSendReceiveMailBox : une boîte aux lettres dépasse sa limite ProhibitSendReceiveQuota.
- WarningMailbox : une boîte aux lettres dépasse sa limite IssueWarningQuota lorsqu’une limite ProhibitSendQuota ou ProhibitSendReceiveQuota est configurée.
- WarningMailbox : une boîte aux lettres dépasse sa limite IssueWarningQuota lorsqu’elle a une limite ProhibitSendQuota ou ProhibitSendReceiveQuota configurée.
WarningMailboxUnlimitedSize : une boîte aux lettres dépasse sa limite IssueWarningQuota lorsqu’elle n’a aucune limite ProhibitSendQuota ou ProhibitSendReceiveQuota configurée.
- Quotas de taille de dossier public :
- WarningPublicFolder : un dossier public dépasse sa limite IssueWarningQuota lorsqu’une limite ProhibitPostQuota est configurée.
- WarningPublicFolder : un dossier public dépasse sa limite IssueWarningQuota lorsqu’il a une limite ProhibitPostQuota configurée.
WarningPublicFolderUnlimitedSize : un dossier public dépasse sa limite IssueWarningQuota lorsqu’il n’a pas de limite ProhibitPostQuota configurée.
- Nombre maximal de messages par dossier de boîte aux lettres :
- WarningMailboxMessagesPerFolderCount : une boîte aux lettres dépasse sa limite MailboxMessagesPerFolderCountWarningQuota lorsqu’une limite MailboxMessagesPerFolderCountReceiveQuota est configurée.
- WarningMailboxMessagesPerFolderCount : une boîte aux lettres dépasse sa limite MailboxMessagesPerFolderCountWarningQuota lorsqu’il a une limite MailboxMessagesPerFolderCountReceiveQuota configurée.
WarningMailboxMessagesPerFolderUnlimitedCount : une boîte aux lettres dépasse sa limite MailboxMessagesPerFolderCountWarningQuota lorsqu’elle n’a pas de limite MailboxMessagesPerFolderCountReceiveQuota configurée.
- Nombre maximal de sous-dossiers par dossier de boîte aux lettres :
- WarningFolderHierarchyChildrenCount : une boîte aux lettres dépasse sa limite FolderHierarchyChildrenCountWarningQuota lorsqu’une limite FolderHierarchyChildrenCountReceiveQuota est configurée.
- WarningFolderHierarchyChildrenCount : une boîte aux lettres dépasse sa limite FolderHierarchyChildrenCountWarningQuota lorsqu’elle a une limite FolderHierarchyChildrenCountReceiveQuota configurée.
- ProhibitReceiveFoldersCount : une boîte aux lettres dépasse sa limite FoldersCountReceiveQuota.
- WarningFoldersCount : une boîte aux lettres dépasse sa limite FoldersCountWarningQuota lorsqu’une limite FoldersCountReceiveQuota est configurée.
- WarningFoldersCountUnlimited Une boîte aux lettres dépasse sa limite FoldersCountWarningQuota lorsqu’elle n’a pas de limite FoldersCountReceiveQuota configurée.
WarningFoldersCountUnlimited Une boîte aux lettres dépasse sa limite FoldersCountWarningQuota lorsqu’elle n’a pas de limite FoldersCountReceiveQuota configurée.
- Nombre maximal de niveaux (profondeur) dans un dossier de boîte aux lettres :
- WarningFolderHierarchyDepth : une boîte aux lettres dépasse sa limite FolderHierarchyDepthWarningQuota lorsqu’une limite FolderHierarchyDepthReceiveQuota est configurée.
- WarningFolderHierarchyDepth : une boîte aux lettres dépasse sa limite FolderHierarchyDepthWarningQuota lorsqu’elle a une limite FolderHierarchyDepthReceiveQuota configurée.
Type: | SystemMessageIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Name
Le paramètre Name spécifie un nom descriptif pour le message système. La longueur maximale est de 64 caractères. Si la valeur contient des espaces, mettez le nom entre guillemets.
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 |
-Original
Le commutateur d’origine spécifie s’il faut arrêter d’utiliser le message système personnalisé et commencer à utiliser le message système par défaut. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Ce commutateur est utile lorsque vous souhaitez conserver le message système personnalisé sans l’utiliser.
Ce commutateur fonctionne uniquement sur les messages système personnalisés pour les valeurs de code d’état améliorée par défaut (et non nouvelles).
Type: | SwitchParameter |
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 |
-Text
Le paramètre Text spécifie le texte dans le message système personnalisé. Le texte doit expliquer pourquoi le message système a été envoyé et toutes les actions que l’utilisateur doit effectuer.
Ce paramètre peut contenir du texte et des balises HTML. La longueur maximale est de 512 caractères (ce qui inclut toutes les balises texte et HTML).
Les balises HTML suivantes sont disponibles :
<B>
et</B>
(gras)<EM>
et</EM>
(italique)<BR>
(saut de ligne)<P>
et</P>
(paragraphe)<A HREF="url">
et</A>
(lien hypertexte)
Vous devez utiliser des guillemets simples (et non des guillemets doubles) autour de la chaîne de texte complète si vous utilisez la balise de lien hypertexte. Dans le cas contraire, vous recevez une erreur (en raison de la présence de guillemets dans la balise).
Utilisez les codes d’échappement suivants pour les caractères spéciaux indiqués ci-dessous :
<
Pour <>
Pour >"
pour »&
Pour &
Voici un exemple de valeur pour ce paramètre qui utilise des caractères spéciaux et des balises HTML :
'You tried to send a message to a <B>disabled</B> mailbox. Please visit <A HREF="https://it.contoso.com">Internal Support</A> or contact "InfoSec" for more information.'
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 |
-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 |
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.