New-SystemMessage
Questo cmdlet è disponibile solo in Exchange locale.
Utilizzare il cmdlet New-SystemMessage per creare i messaggi di sistema personalizzati. 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
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>] 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
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."In questo esempio viene creato un rapporto di mancato recapito personalizzato in inglese per il codice di stato avanzato 5.3.5 per i mittenti esterni.
Esempio 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."In questo esempio viene creato un messaggio di quota personalizzato in inglese per le cassette postali che superano la quota di avviso problema.
Parametri
-Confirm
L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.
- I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi:
-Confirm:$false. - La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
| 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
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 |
-DsnCode
Il parametro DsnCode consente di specificare il codice di stato avanzato per il messaggio di sistema personalizzato.
I valori validi sono 4.x.y o 5.x.y, dove x e y sono numeri da uno a tre cifre. È possibile specificare un codice predefinito incluso in Exchange oppure specificare un codice personalizzato.
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".
È necessario utilizzare questo parametro con i parametri Language e Internal.
Non è possibile utilizzare questo parametro con il parametro 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
Il parametro Internal consente di specificare se il messaggio di sistema viene visualizzato dagli utenti interni o esterni. I valori validi sono:
- $true: il rapporto di mancato recapito viene visualizzato ai mittenti interni.
- $false: il rapporto di mancato recapito viene visualizzato ai mittenti esterni.
È necessario utilizzare questo parametro con i parametri DsnCode e Language.
Non è possibile utilizzare questo parametro con il parametro 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
Il parametro Language consente di specificare la lingua del messaggio, ad esempio en per l'inglese o ja per il giapponese. Per l'elenco dei codici lingua supportati, vedere Lingue supportate per le richieste di recapito.
È necessario utilizzare questo parametro con i parametri DsnCode o 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
Il parametro QuotaMessageType consente di specificare la quota per il messaggio di sistema personalizzato. 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 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.
È necessario utilizzare questo parametro con il parametro Language.
Non è possibile utilizzare questo parametro con i parametri DsnCode o 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
Il parametro Text consente di specificare il testo del messaggio di sistema personalizzato. Il testo deve spiegare perché è stato inviato il messaggio di sistema e le azioni che l'utente dovrà eseguire.
È necessario utilizzare questo parametro con i parametri DsnCode o QuotaMessageType.
Il parametro può contenere testo e tag HTML. La lunghezza massima è di 512 caratteri (che include tutti i tag html e di testo).
Sono disponibili i seguenti tag HTML:
<B>e</B>(grassetto)<EM>e</EM>(corsivo)<BR>(interruzione di riga)<P>e</P>(paragrafo)<A HREF="url">e</A>(collegamento ipertestuale). Nota: È necessario utilizzare virgolette singole (non le virgolette doppie) intorno alla stringa di testo completa se si utilizza questo tag. In caso contrario, verrà visualizzato un errore (a causa delle virgolette doppie nel tag).
Utilizzare i seguenti codici di escape per questi caratteri speciali:
<Per <>Per >"per "&Per &
Ecco un valore di esempio per questo parametro che utilizza tag HTML e caratteri speciali:
'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
L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.
| 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 |
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.
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per