New-SystemMessage
Si applica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Ultima modifica dell'argomento: 2007-07-27
Il cmdlet New-SystemMessage in Microsoft Exchange Server 2007 consente di creare nuovi messaggi DSN o di quota personalizzati, nella lingua specificata, su computer in cui è installato il ruolo server Trasporto Hub o Trasporto Edge.
Sintassi
New-SystemMessage -DsnCode <EnhancedStatusCode> -Internal <$true | $false> -Language <CultureInfo> -Text <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]
New-SystemMessage -Language <CultureInfo> -QuotaMessageType <WarningMailboxUnlimitedSize | WarningPublicFolderUnlimitedSize | WarningMailbox | WarningPublicFolder | ProhibitSendMailbox | ProhibitPostPublicFolder | ProhibitSendReceiveMailBox> -Text <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Questo cmdlet consente di creare nuovi messaggi DSN e di quota personalizzati. I messaggi DSN vengono inviati al mittente di messaggi di posta elettronica che non raggiungono i relativi destinatari. 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 DSN e di quota personalizzati sostituiscono i messaggi DSN o di quota integrati inclusi con Exchange Server.
Nell'elenco seguente vengono descritte le condizioni di errore che attivano i messaggi DSN con uno stato di recapito di errore temporaneo persistente e di errore permanente.
Messaggi DSN 4.X.X. Questo tipo di messaggi DSN viene generato quando esiste un problema temporaneo con il server o con la cassetta postale del destinatario. Di norma, questi problemi si risolvono automaticamente e consentono il recapito corretto del messaggio di posta elettronica. Un esempio di errore temporaneo e persistente 4.X.X. è dato da un server non in linea impossibile da raggiungere.
Messaggi DSN 5.X.X. Questo tipo di messaggi DSN viene generato quando si verifica un errore permanente o un errore irreversibile relativo al server o alla cassetta postale del destinatario. Questi errori non possono essere superati dal server di invio della posta, pertanto il messaggio viene reinviato al mittente. Un esempio di errore permanente 5.X.X. è dato da un indirizzo SMTP inesistente.
Per eseguire il cmdlet New-SystemMessage, è necessario utilizzare un account che disponga della seguente delega:
- Ruolo Exchange Organization Administrator
Per eseguire il cmdlet New-SystemMessage su un computer in cui è installato il ruolo del server Edge Transport, è necessario accedere al sistema utilizzando un account che sia membro del gruppo Administrators locale del computer.
Per ulteriori informazioni sulle autorizzazioni, sulla delega dei ruoli e sui diritti necessari per l'amministrazione di Exchange 2007, vedere Considerazioni sulle autorizzazioni.
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
DsnCode |
Obbligatorio |
Microsoft.Exchange.Data.EnhancedStatusCode |
Questo parametro consente di specificare il codice DSN al quale è applicato il messaggio DSN. Il parametro può essere un codice integrato oppure un codice personalizzato definito dall'amministratore. Nota Si tratta di un parametro non obbligatorio e non può essere utilizzato quando viene specificato il parametro QuotaMessageType. |
Internal |
Obbligatorio |
System.Boolean |
Questo parametro consente di specificare se il messaggio viene visualizzato dagli utenti all'interno dell'organizzazione di Exchange Server. Per messaggi visualizzati solo internamente, immettere Nota Si tratta di un parametro non obbligatorio e non può essere utilizzato quando viene specificato il parametro QuotaMessageType. |
Language |
Obbligatorio |
System.Globalization.CultureInfo |
Questo parametro consente di specificare la lingua del messaggio. Il messaggio può essere creato in qualsiasi lingua supportata da Exchange Server. Le lingue vengono specificate mediante l'utilizzo del nome locale. Ad esempio, inglese corrisponde a "en". giapponese a "ja". Per l'elenco completo dei nomi locali, vedere Impostazioni internazionali supportate per l'utilizzo con i messaggi di sistema. |
QuotaMessageType |
Obbligatorio |
Microsoft.Exchange.Data.Directory.SystemConfiguration.QuotaMessageType |
Questo parametro consente di selezionare il tipo di messaggio di quota da creare. I valori validi per il parametro QuotaMessageType sono i seguenti:
Nota Si tratta di un parametro non obbligatorio e non può essere utilizzato quando viene specificato il parametro DsnCode. |
Text |
Obbligatorio |
System.String |
Questo parametro consente di specificare il testo del messaggio visualizzato dai mittenti o dai proprietari delle cassette postali. Tale testo deve descrivere il motivo per cui il messaggio è stato creato e le eventuali azioni che il mittente o il proprietario della cassetta postale deve eseguire. |
Confirm |
Facoltativo |
System.Management.Automation.SwitchParameter |
Il parametro Confirm consente di determinare la sospensione dell'elaborazione e di richiedere che l'utente confermi l'operazione che verrà eseguita dal comando prima che l'elaborazione continui. Con il parametro Confirm non è necessario specificare un valore. |
DomainController |
Facoltativo |
Microsoft.Exchange.Data.Fqdn |
Per specificare il nome di dominio completo (FQDN) del controller di dominio che consente di recuperare i dati dal servizio directory di Active Directory, includere nel comando il parametro DomainController. Il parametro DomainController non è supportato nei computer che eseguono il ruolo del server Edge Transport. Il ruolo del server Edge Transport prevede la scrittura e la lettura solo dall'istanza locale Active Directory Application Mode (ADAM). |
WhatIf |
Facoltativo |
System.Management.Automation.SwitchParameter |
Il parametro WhatIf consente di indicare al comando di simulare le azioni da eseguire sull'oggetto. Il parametro WhatIf consente di visualizzare le modifiche che verrebbero apportate senza applicarle. Con il parametro WhatIf non è necessario specificare un valore. |
Tipi di input
Tipi restituiti
Errori
| Errore | Descrizione |
|---|---|
Eccezioni
| Eccezioni | Descrizione |
|---|---|
Esempio
Nel seguente codice di esempio il primo esempio consente di aggiungere un nuovo messaggio DSN personalizzato con il codice DSN 5.3.5. Questo messaggio DSN verrà visualizzato solo dagli utenti esterni. Il testo del messaggio DSN è incluso nella riga di comando insieme alla lingua del messaggio, l'inglese.
Il secondo esempio consente di aggiungere un nuovo messaggio di quota WarningMailbox personalizzato. Questo messaggio verrà visualizzato dagli utenti che soddisfano i seguenti criteri:
La cassetta postale ha superato il limite di avviso configurato.
Non sono state configurate quote per attivare Impedisci invio o Impedisci ricezione per la cassetta postale.
La cassetta postale si trova su un server che utilizza l'inglese come lingua locale.
New-SystemMessage -DsnCode 5.3.5 -Language En -Internal $false -Text "The recipient e-mail system can't process this e-mail message. Please contact your system administrator for more information."
New-SystemMessage -QuotaMessageType WarningMailbox -Language En -Text "Your mailbox has exceeded the warning limit specified by your e-mail administrator. Please reduce the size of your mailbox."