Set-SystemMessage

  • Articolo

 

Si applica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Ultima modifica dell'argomento: 2007-09-05

Il cmdlet Set-SystemMessage in Microsoft Exchange Server 2007 consente di modificare i messaggi DSN o di quota personalizzati esistenti, nella lingua specificata, su computer in cui è installato il ruolo del server Trasporto Hub o Edge Transport.

Sintassi

Set-SystemMessage -Identity <SystemMessageIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Name <String>] [-Original <SwitchParameter>] [-Text <String>] [-WhatIf [<SwitchParameter>]]

Set-SystemMessage [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Instance <SystemMessage>] [-Name <String>] [-Original <SwitchParameter>] [-Text <String>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Questo cmdlet consente di modificare i 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.

Nota   Il server Exchange è preconfigurato con diversi messaggi DSN standard, che non è possibile modificare utilizzando questo cmdlet. Al contrario, è necessario creare un nuovo messaggio DSN, con lo stesso codice DSN, per sostituire i messaggi preconfigurati.

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 Set-SystemMessage, è necessario utilizzare un account che disponga della seguente delega:

  • Ruolo Exchange Organization Administrator

Per eseguire il cmdlet Set-SystemMessage su un computer in cui è installato il ruolo del server Trasporto Edge, è 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

Identity

Obbligatorio

Microsoft.Exchange.Configuration.Tasks.SystemMessageIdParameter

Questo parametro consente di specificare l'identità del messaggio DSN o di quota da modificare.

Per modificare un messaggio DSN, utilizzare il formato seguente: lingua\interno | esterno\codice di sistema. Per ulteriori informazioni sulla sintassi dell'identità del messaggio DSN, vedere Identità dei messaggi di notifica sullo stato del recapito.

Per modificare un messaggio di quota personalizzato, utilizzare il formato seguente: language\QuotaMessageType. Il parametro Language viene espresso come codice a due caratteri delle impostazioni locali. I valori validi per il parametro QuotaMessageType sono i seguenti:

  • WarningMailboxUnlimitedSize   Inviato quando una cassetta postale che non dispone di quote per l'attivazione di Impedisci invio o Impedisci ricezione supera il limite di avviso specificato per la cassetta postale.

  • WarningPublicFolderUnlimitedSize    Inviato quando una cartella pubblica che non dispone di una quota per l'attivazione di Impedisci l'invio o Impedisci la ricezione supera il limite di avviso specificato per la cartella pubblica.

  • WarningMailbox    Inviato quando una cassetta postale che dispone di quote per attivare Impedisci invio o Impedisci ricezione supera il limite di avviso specificato per la cassetta postale.

  • WarningPublicFolder    Inviato quando una cartella pubblica che dispone di una quota per l'attivazione di Impedisci l'invio o Impedisci la ricezione supera il limite di avviso specificato per la cartella pubblica.

  • ProhibitSendMailbox    Inviato quando una cassetta postale che dispone di una quota per l'attivazione di Impedisci l'invio supera il limite della dimensione specificato per la cassetta postale.

  • ProhibitPostPublicFolder    Inviato quando una cartella pubblica che dispone di una quota per l'attivazione di Impedisci l'invio supera il limite della dimensione specificato per la cartella pubblica.

  • ProhibitSendReceiveMailBox    Inviato quando una cassetta postale che dispone di una quota per l'attivazione di Impedisci l'invio e Impedisci la ricezione supera il limite della dimensione di invio e ricezione specificato per la cassetta postale.

L'etichetta del parametro Identity può essere omessa.

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, Fully Qualified Domain Name) del controller di dominio che consente di scrivere i dati per il servizio directory di Active Directory, includere nel comando il parametro DomainController. Il parametro DomainController non è supportato nei computer che eseguono il ruolo del server Trasporto Edge. Il ruolo del server Trasporto Edge prevede la scrittura e la lettura solo dall'istanza locale Active Directory Application Mode (ADAM).

Instance

Facoltativo

Microsoft.Exchange.Data.Directory.SystemConfiguration.SystemMessage

Questo parametro consente di trasmettere il messaggio DSN o di quota al comando da elaborare. Questo parametro risulta utile negli script in cui è necessario passare l'intero oggetto al comando.

Name

Facoltativo

System.String

Questo parametro consente di specificare il nome che è possibile utilizzare per descrivere il messaggio DSN o di quota.

Original

Facoltativo

System.Management.Automation.SwitchParameter

Questo parametro consente di ripristinare il testo del messaggio DSN o di quota nel testo fornito in origine e risulta utile quando non si desidera rimuovere la voce DSN o di quota personalizzata ma si desidera ripristinarla sul testo di origine.

Text

Facoltativo

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.

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 modificare il testo inglese di un messaggio DSN personalizzato esistente con il codice DSN 5.3.5. Questo messaggio DSN viene visualizzato solo dagli utenti esterni. Il testo del messaggio DSN è incluso nella riga di comando.

Il secondo esempio consente di modificare il testo inglese di un messaggio di quota WarningMailbox personalizzato esistente.

Set-SystemMessage En\Internal\5.3.5 -Text "The recipient e-mail system can't process this e-mail message. Please contact your system administrator for more information."
Set-SystemMessage En\WarningMailbox -Text "Your mailbox has exceeded the warning limit specified by your e-mail administrator. Please reduce the size of your mailbox."