New-SystemMessage

Modulo:: Exchange PowerShell

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

Dsn

New-SystemMessage
    -DsnCode <EnhancedStatusCode>
    -Internal <Boolean>
    -Language <CultureInfo>
    -Text <String>
    [-Confirm]
    [-DomainController <Fqdn>]
    [-WhatIf]
    [<CommonParameters>]

Quota

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. Anche se questo articolo elenca tutti i parametri per il cmdlet, è possibile che non si abbia accesso ad alcuni parametri se non sono inclusi nelle autorizzazioni assegnate all'utente. 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

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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-*) dispongono di una pausa incorporata che impone all'utente 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 dispone di una pausa incorporata. 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.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False
Alias:	cfr

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

-DomainController

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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

-DsnCode

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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.

Proprietà dei parametri

Tipo:	EnhancedStatusCode
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

Dsn

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Internal

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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.

Proprietà dei parametri

Tipo:	Boolean
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

Dsn

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Language

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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.

Proprietà dei parametri

Tipo:	CultureInfo
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-QuotaMessageType

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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.

Proprietà dei parametri

Tipo:	QuotaMessageType
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

Quota

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Text

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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:

 e  (grassetto)
 e  (corsivo)
  (interruzione di riga)
 e  (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, viene 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 disabled mailbox. Please visit <A HREF="https://it.contoso.com">Internal Support</A> or contact "InfoSec" for more information.'

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-WhatIf

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False
Alias:	Wi

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

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.

Commenti e suggerimenti

Questa pagina è stata utile?

Condividi tramite

New-SystemMessage

Sintassi

Dsn

Quota

Descrizione

Esempio

Esempio 1

Esempio 2

Parametri

-Confirm

Proprietà dei parametri

Set di parametri

-DomainController

Proprietà dei parametri

Set di parametri

-DsnCode

Proprietà dei parametri

Set di parametri

-Internal

Proprietà dei parametri

Set di parametri

-Language

Proprietà dei parametri

Set di parametri

-QuotaMessageType

Proprietà dei parametri

Set di parametri

-Text

Proprietà dei parametri

Set di parametri

-WhatIf

Proprietà dei parametri

Set di parametri

CommonParameters

Input

Input types

Output

Output types

Commenti e suggerimenti