Get-SystemMessage
La cmdlet est disponible uniquement dans Exchange en local.
Utilisez la cmdlet Get-SystemMessage pour afficher les messages système par défaut ou 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
Get-SystemMessage
[[-Identity] <SystemMessageIdParameter>]
[-DomainController <Fqdn>]
[<CommonParameters>]
Get-SystemMessage
[-Original]
[-DomainController <Fqdn>]
[<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
Get-SystemMessage
Cet exemple affiche la liste récapitulative de tous les messages système personnalisés dans votre organisation.
Exemple 2
Get-SystemMessage En\Internal\5.3.2 | Format-List
Cet exemple affiche des informations détaillées sur la notification d’échec de remise personnalisée spécifiée (combinaison de valeurs de langue, de public et de code d’état amélioré).
Exemple 3
Get-SystemMessage En\WarningMailbox | Format-List
Cet exemple affiche des informations détaillées sur le message de quota personnalisé spécifié (combinaison de valeurs de langue et de quota).
Exemple 4
Get-SystemMessage -Original | Select-Object -Property Identity,DsnCode,Language,Text | ConvertTo-Html | Set-Content -Path "C:\My Documents\Default System Messages.html"
Cet exemple génère la liste de tous les messages système par défaut dans toutes les langues dans un fichier HTML nommé C:\My Documents\Default System Messages.html.
Vous devez générer la liste dans un fichier, car elle est très longue, et vous recevez des erreurs si les modules de prise en charge linguistique nécessaires ne sont pas installés.
Paramètres
-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 afficher. 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
Vous ne pouvez pas utiliser ce paramètre avec le commutateur Original.
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: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Original
Le commutateur d’origine filtre les résultats en fonction des messages système par défaut inclus dans Exchange. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Vous ne pouvez pas utiliser ce commutateur avec le paramètre Identity.
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 |
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.