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
Identity
Get-SystemMessage
[[-Identity] <SystemMessageIdParameter>]
[-DomainController <Fqdn>]
[<CommonParameters>]
Original
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 rapporti di mancato recapito personalizzati e i messaggi quota sostituiscono i messaggi predefiniti inclusi in Exchange.
È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Anche se questo articolo elenca tutti i parametri per il cmdlet, si potrebbe non avere accesso ad alcuni parametri se non sono 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.
È consigliabile eseguire l'output dell'elenco in un file, poiché l'elenco è molto lungo e si verificano errori se non sono installati i Language Pack richiesti.
Parametri
-DomainController
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Proprietà dei parametri
| Tipo: | Fqdn |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Identity
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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 i codici di stato avanzati:
Language\<Internal | External>\DSNCode. Ad esempio,En\Internal\5.1.2oJa\External\5.1.2. - Messaggi di sistema per le quote:
Language\QuotaMessageType. Ad esempio,En\ProhibitSendReceiveMailbox.
<Lingua>: per l'elenco dei codici lingua supportati, vedere Lingue supportate per i rapporti di mancato recapito.
<DSNCode>: i valori validi sono 4.x.y o 5.x.y, dove x e y sono numeri da una a tre cifre. Per visualizzare i codici di sistema avanzati attualmente utilizzati dai messaggi di sistema personalizzati, eseguire il comando Get-SystemMessage. Per generare un elenco di codici di stato avanzato predefiniti utilizzati 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>: I valori validi sono:
È 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 di ProhibitSendReceiveQuota.
- ProhibitSendReceiveMailBox: una cassetta postale supera il suo limite ProhibitSendReceiveQuota.
- WarningMailbox: una cassetta postale supera il limite di IssueWarningQuota quando è configurato un limite di 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 di MailboxMessagesPerFolderCountWarningQuota quando è configurato un limite di 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 di FolderHierarchyChildrenCountWarningQuota quando è configurato un limite di FolderHierarchyChildrenCountReceiveQuota.
- WarningFolderHierarchyChildrenCount: una cassetta postale supera il suo limite FolderHierarchyChildrenCountWarningQuota quando ha un limite FolderHierarchyChildrenCountReceiveQuota configurato.
- ProhibitReceiveFoldersCount: una cassetta postale supera il limite di FoldersCountReceiveQuota.
- WarningFoldersCount: una cassetta postale supera il limite di FoldersCountWarningQuota quando è configurato un limite di FoldersCountReceiveQuota.
- WarningFoldersCountUnlimited Una cassetta postale supera il limite di FoldersCountWarningQuota quando non è configurato un limite di 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 di FolderHierarchyDepthWarningQuota quando è configurato un limite di FolderHierarchyDepthReceiveQuota.
- WarningFolderHierarchyDepth: una cassetta postale supera il suo limite FolderHierarchyDepthWarningQuota quando ha un limite FolderHierarchyDepthReceiveQuota configurato.
Attenzione: il valore $null o un valore inesistente per il parametro Identity restituisce tutti gli oggetti come se si eseguisse il comando Get- senza il parametro Identity. Verificare che tutti gli elenchi di valori per il parametro Identity siano accurati e non contengano valori $null inesistenti.
Proprietà dei parametri
| Tipo: | SystemMessageIdParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Identity
| Posizione: | 1 |
| Obbligatorio: | False |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-Original
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
L'opzione Original 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.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Original
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.
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.