Set-SystemMessage

  • Riferimento
Modulo:
ExchangePowerShell
Si applica a:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Questo cmdlet è disponibile solo in Exchange locale.

Utilizzare il cmdlet Set-SystemMessage per modificare 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

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

Descrizione

È 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

Set-SystemMessage En\Internal\5.3.5 -Text "The recipient email system can't process this email message. Please contact your system administrator for more information."

In questo esempio viene modificato il testo del messaggio di sistema inglese personalizzato per il codice di stato avanzato 5.3.5 per i mittenti interni.

Esempio 2

Set-SystemMessage En\WarningMailbox -Text "Your mailbox has exceeded the warning limit specified by your email administrator. Please reduce the size of your mailbox."

Questo esempio consente di modificare il testo del messaggio di quota personalizzato in inglese WarningMailbox.

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

-Identity

Il parametro Identity consente di specificare il messaggio di sistema personalizzato che si desidera modificare. È possibile utilizzare qualsiasi valore che identifichi il messaggio di sistema in modo univoco. Ad esempio:

  • Identità
  • Nome distinto (DN)
  • GUID

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 o Ja\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:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Name

Il parametro Name consente di specificare un nome descrittivo per il messaggio di stato. La lunghezza massima è 64 caratteri. Se il valore contiene spazi è necessario racchiuderlo tra virgolette.

Type:String
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

-Original

L'opzione Originale specifica se interrompere l'uso del messaggio di sistema personalizzato e iniziare a usare il messaggio di sistema predefinito. Con questa opzione non è necessario specificare alcun valore.

Questa opzione è utile quando si desidera mantenere il messaggio di sistema personalizzato senza usarlo.

Questa opzione funziona solo nei messaggi di sistema personalizzati per valori di codici di stato avanzati predefiniti (non nuovi).

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

-Text

Il parametro Text consente di specificare il testo del messaggio di sistema personalizzato. Il testo dovrebbe spiegare il motivo per cui è stato inviato il messaggio di sistema e le azioni che l'utente deve intraprendere.

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)

È necessario usare virgolette singole (non virgolette doppie) intorno alla stringa di testo completa se si usa il tag collegamento ipertestuale. In caso contrario, verrà visualizzato un errore (a causa delle virgolette doppie nel tag).

Utilizzare i seguenti codici di escape per questi caratteri speciali:

  • &lt; Per <
  • &gt; Per >
  • &quot; per "
  • &amp; 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 &quot;InfoSec&quot; for more information.'

Type:String
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

-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.