Get-SystemMessage
Questo cmdlet è disponibile solo in Exchange locale.
Utilizzare il cmdlet Get-SystemMessage per visualizzare i messaggi di sistema personalizzati o predefiniti. I messaggi di sistema sono notifiche sullo stato del recapito (noti anche come DNS, rapporti di mancato recapito, NDR o notifiche di mancato recapito) e messaggi di quota.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Get-SystemMessage
[[-Identity] <SystemMessageIdParameter>]
[-DomainController <Fqdn>]
[<CommonParameters>]
Get-SystemMessage
[-Original]
[-DomainController <Fqdn>]
[<CommonParameters>]
Descrizione
Gli NDR vengono inviati al mittente dei messaggi di posta elettronica che non hanno raggiunto i destinatari previsti. I messaggi di quota vengono inviati agli utenti le cui cassette postali o cartelle pubbliche hanno raggiunto la quota che attiva l'invio di un avviso specifico oppure il blocco della funzionalità di invio o ricezione. I messaggi di mancato recapito e quota personalizzati sostituiscono i messaggi predefiniti inclusi in Exchange.
È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.
Esempio
Esempio 1
Get-SystemMessage
In questo esempio viene visualizzato un elenco riepilogativo di tutti i messaggi di sistema personalizzati nell'organizzazione.
Esempio 2
Get-SystemMessage En\Internal\5.3.2 | Format-List
In questo esempio vengono riportate informazioni dettagliate per l'NDR personalizzato specificato (combinazione dei valori di lingua, gruppo di destinatari e codice di stato avanzato).
Esempio 3
Get-SystemMessage En\WarningMailbox | Format-List
In questo esempio vengono riportate informazioni dettagliate per il messaggio di quota personalizzato specificato (combinazione dei valori di lingua e quota).
Esempio 4
Get-SystemMessage -Original | Select-Object -Property Identity,DsnCode,Language,Text | ConvertTo-Html | Set-Content -Path "C:\My Documents\Default System Messages.html"
In questo esempio viene riportato l'elenco di tutti i messaggi di sistema predefiniti in tutte le lingue in un file HTML denominato C:\My Documents\Default System Messages.html.
È necessario inserire l'elenco in un file perché è molto lungo e, se non sono stati installati i Language Pack necessari, si ricevono degli errori.
Parametri
-DomainController
Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, dc01.contoso.com.
Il parametro DomainController non è supportato sui server Trasporto Edge. Un server Trasporto Edge usa l'istanza locale di Active Directory Lightweight Directory Services (AD LDS) per leggere e scrivere i dati.
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
Il parametro Identity consente di specificare il messaggio di sistema personalizzato che si desidera visualizzare. È possibile utilizzare qualsiasi valore che identifichi il messaggio di sistema in modo univoco. Ad esempio:
- Identità
- Nome distinto (DN)
- GUID
Non è possibile utilizzare questo parametro con l'opzione Original.
Il valore di identità di un messaggio di sistema usa uno dei formati seguenti:
- Messaggi di sistema per codici di stato avanzati:
Language\<Internal | External>\DSNCode
. Ad esempio,En\Internal\5.1.2
oJa\External\5.1.2
. - Messaggi di sistema per le quote:
Language\QuotaMessageType
. Ad esempio,En\ProhibitSendReceiveMailbox
.
<Lingua>: per l'elenco dei codici di lingua supportati, vedere Lingue supportate per INDR.
<DSNCode>: i valori validi sono 4.x.y o 5.x.y dove x e y sono numeri da uno a tre cifre. Per visualizzare i codici di sistema avanzati attualmente usati dai messaggi di sistema personalizzati, eseguire il comando Get-SystemMessage
. Per generare un elenco di codici di stato avanzati predefiniti usati da Exchange, eseguire questo comando: Get-SystemMessage -Original | Select-Object -Property Identity,DsnCode,Language,Text | ConvertTo-Html | Set-Content -Path "C:\My Documents\Default DSNs.html"
.
<QuotaMessageType>: il valore valido è:
È possibile specificare più criteri utilizzando l'operatore di confronto and. I valori di proprietà non espressi con un numero intero devono essere racchiusi tra virgolette (").
- ProhibitSendReceiveMailbox: una cassetta postale supera il limite ProhibitSendReceiveQuota.
- ProhibitSendReceiveMailBox: una cassetta postale supera il suo limite ProhibitSendReceiveQuota.
- WarningMailbox: una cassetta postale supera il limite IssueWarningQuota quando è configurato un limite ProhibitSendQuota o ProhibitSendReceiveQuota.
- WarningMailbox: una cassetta postale supera il suo limite IssueWarningQuota quando ha un limite ProhibitSendQuota o ProhibitSendReceiveQuota configurato.
WarningMailboxUnlimitedSize: una cassetta postale supera il suo limite IssueWarningQuota quando non ha un limite ProhibitSendQuota o ProhibitSendReceiveQuota configurato.
- Quote di dimensione cartella pubblica:
- WarningPublicFolder: una cartella pubblica supera il limite IssueWarningQuota quando è configurato un limite ProhibitPostQuota.
- WarningPublicFolder: una cartella pubblica supera il suo limite IssueWarningQuota quando ha un limite ProhibitPostQuota configurato.
WarningPublicFolderUnlimitedSize: una cartella pubblica supera il suo limite IssueWarningQuota quando non ha un limite ProhibitPostQuota configurato.
- Numero massimo di messaggi nella cartella delle cassette postali:
- WarningMailboxMessagesPerFolderCount: una cassetta postale supera il limite MailboxMessagesPerFolderCountWarningQuota quando è configurato un limite MailboxMessagesPerFolderCountReceiveQuota.
- WarningMailboxMessagesPerFolderCount: una cassetta postale supera il suo limite MailboxMessagesPerFolderCountWarningQuota quando ha un limite MailboxMessagesPerFolderCountReceiveQuota configurato.
WarningMailboxMessagesPerFolderUnlimitedCount: una cassetta postale supera il suo limite MailboxMessagesPerFolderCountWarningQuota quando non ha un limite MailboxMessagesPerFolderCountReceiveQuota configurato.
- Numero massimo di sottocartelle in una cartella delle cassette postali:
- WarningFolderHierarchyChildrenCount: una cassetta postale supera il limite FolderHierarchyChildrenCountWarningQuota quando è configurato un limite FolderHierarchyChildrenCountReceiveQuota.
- WarningFolderHierarchyChildrenCount: una cassetta postale supera il suo limite FolderHierarchyChildrenCountWarningQuota quando ha un limite FolderHierarchyChildrenCountReceiveQuota configurato.
- ProhibitReceiveFoldersCount: una cassetta postale supera il limite FoldersCountReceiveQuota.
- WarningFoldersCount: una cassetta postale supera il limite FoldersCountWarningQuota quando è configurato un limite FoldersCountReceiveQuota.
- WarningFoldersCountUnlimited Una cassetta postale supera il limite FoldersCountWarningQuota quando non è configurato un limite FoldersCountReceiveQuota.
WarningFoldersCountUnlimited: una cassetta postale supera il suo limite FoldersCountWarningQuota quando non ha un limite FoldersCountReceiveQuota configurato.
- Numero massimo di livelli (profondità) in una cartella delle cassette postali:
- WarningFolderHierarchyDepth: una cassetta postale supera il limite FolderHierarchyDepthWarningQuota quando è configurato un limite FolderHierarchyDepthReceiveQuota.
- WarningFolderHierarchyDepth: una cassetta postale supera il suo limite FolderHierarchyDepthWarningQuota quando ha un limite FolderHierarchyDepthReceiveQuota configurato.
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
L'opzione Originale filtra i risultati in base ai messaggi di sistema predefiniti inclusi in Exchange. Con questa opzione non è necessario specificare alcun valore.
Non è possibile utilizzare questa opzione con il parametro 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 |
Input
Input types
Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.
Output
Output types
Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.