New-SystemMessage
La cmdlet est disponible uniquement dans Exchange en local.
Utilisez la cmdlet New-SystemMessage pour créer des 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
New-SystemMessage
-DsnCode <EnhancedStatusCode>
-Internal <Boolean>
-Language <CultureInfo>
-Text <String>
[-Confirm]
[-DomainController <Fqdn>]
[-WhatIf]
[<CommonParameters>]
New-SystemMessage
-Language <CultureInfo>
-QuotaMessageType <QuotaMessageType>
-Text <String>
[-Confirm]
[-DomainController <Fqdn>]
[-WhatIf]
[<CommonParameters>]
Description
Les notifications d’échec de remise sont envoyées aux expéditeurs de messages électroniques n’ayant pas atteint leur destinataire. Les 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 NDR personnalisés et les messages de quota remplacent les messages par défaut inclus dans Exchange.
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-SystemMessage -DsnCode 5.3.5 -Language en -Internal $false -Text "The recipient email system can't process this email message. Please contact your system administrator for more information."
L’exemple suivant crée une notification d’échec de remise personnalisée en anglais pour le code d’état étendu 5.3.5 pour les expéditeurs externes.
Exemple 2
New-SystemMessage -QuotaMessageType WarningMailbox -Language en -Text "Your mailbox has exceeded the warning limit specified by your email administrator. Please reduce the size of your mailbox."
Cet exemple crée un message de quota personnalisé en anglais pour les boîtes aux lettres qui dépassent leur quota d’avertissement de problème.
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 |
-DsnCode
Le paramètre DsnCode indique le code d’état étendu du message système personnalisé.
Les valeurs valides sont 4.x.y ou 5.x.y, où x et y sont des nombres à un à trois chiffres. Vous pouvez spécifier un code par défaut inclus dans Exchange, ou vous pouvez spécifier un code personnalisé.
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"
.
Vous devez utiliser ce paramètre avec les paramètres Language et Internal.
Vous ne pouvez pas utiliser ce paramètre avec le paramètre QuotaMessageType.
Type: | EnhancedStatusCode |
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 |
-Internal
Le paramètre Internal spécifie si le message système est affiché pour les utilisateurs internes ou externes. Les valeurs valides sont les suivantes :
- $true : la remise est affichée aux expéditeurs internes.
- $false : la remise est affichée aux expéditeurs externes.
Vous devez utiliser ce paramètre avec les paramètres DsnCode et Language.
Vous ne pouvez pas utiliser ce paramètre avec le paramètre QuotaMessageType.
Type: | Boolean |
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 |
-Language
Le paramètre Language spécifie la langue du message (par exemple, en pour l’anglais ou ja pour le japonais). Pour obtenir la liste des codes de langue pris en charge, consultez Langues prises en charge pour les NDR.
Vous devez utiliser ce paramètre avec les paramètres DsnCode ou QuotaMessageType.
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 |
-QuotaMessageType
Le paramètre QuotaMessageType indique le quota pour le message système personnalisé. 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.
Vous devez utiliser ce paramètre avec le paramètre Language.
Vous ne pouvez pas utiliser ce paramètre avec les paramètres DsnCode ou Internal.
Type: | QuotaMessageType |
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 |
-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é, ainsi que toutes les actions que l’utilisateur doit effectuer.
Vous devez utiliser ce paramètre avec les paramètres DsnCode ou QuotaMessageType.
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). Remarque : vous devez placer la chaîne de texte complète entre apostrophes (et non entre guillemets) si vous utilisez cette balise. 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: | True |
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.