New-MessageClassification

 

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

Ultima modifica dell'argomento: 2007-06-28

Il cmdlet New-MessageClassification consente di creare una nuova istanza di classificazione dei messaggi nella propria organizzazione di Exchange. Dopo aver creato una nuova classificazione dei messaggi, è possibile specificare la classificazione dei messaggi come predicato della regola di trasporto. Prima che gli utenti di Microsoft Office Outlook 2007 e di Outlook Web Access 2007 possano applicare la classificazione dei messaggi ai messaggi, è necessario aggiornare i sistemi dell'utente finale con il file XML di classificazione dei messaggi creato dal file di script Export-OutlookClassification.ps1. Il file di script Export-OutlookClassification.ps1 si trova nella directory \Programmi\Microsoft\Exchange Server\Script.

Quando si crea una nuova classificazione dei messaggi, essa non è associata a nessuna lingua. Per impostazione predefinita, la nuova classificazione dei messaggi viene utilizzata per tutte le lingue. Dopo la definizione di una classificazione dei messaggi predefinita, è possibile aggiungere nuove lingue alla classificazione eseguendo il cmdlet New-MessageClassification e specificando l'identità predefinita della classificazione dei messaggi che si desidera localizzare.

Sintassi

New-MessageClassification -Name <String> -DisplayName <String> -SenderDescription <String> [-ClassificationID <Guid>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-RecipientDescription <String>] [-TemplateInstance <PSObject>] [-UserDisplayEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]

New-MessageClassification -Identity <MessageClassificationIdParameter> -Locale <CultureInfo> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-RecipientDescription <String>] [-SenderDescription <String>] [-TemplateInstance <PSObject>] [-UserDisplayEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Per eseguire il cmdlet New-MessageClassification, è necessario utilizzare un account che disponga della seguente delega:

• Ruolo Exchange Organization Administrator

Per ulteriori informazioni sulle autorizzazioni, sulla delega dei ruoli e sui diritti necessari per l'amministrazione di Microsoft Exchange Server 2007, vedere Considerazioni sulle autorizzazioni.

Parametri

Parametro	Obbligatorio	Tipo	Descrizione
DisplayName	Obbligatorio	System.String	Utilizzare il parametro DisplayName per specificare il nome da visualizzare per l'istanza di classificazione dei messaggi. Il nome da visualizzare compare in Office 2007 e viene utilizzato dagli utenti di Outlook per selezionare la classificazione dei messaggi appropriata prima di inviare un messaggio. Nota Perché il nome da visualizzare venga visualizzato, è necessario che il file XML di classificazione dei messaggi sia presente sul computer del mittente. Se il parametro UserDisplayEnabled viene impostato su $true, viene visualizzato il nome da visualizzare per il ricevente, anche se non è stato installato nessun file XML di classificazione dei messaggi. Quando si specifica un nome che include spazi, è necessario includere l'intero nome tra virgolette come indicato di seguito, ad esempio "Display Name". Il parametro DisplayName non può contenere più di 64 caratteri.
Identity	Obbligatorio	Microsoft.Exchange.Configuration.Tasks.MessageClassificationIdParameter	Questo parametro consente di creare una versione tradotta di una classificazione dei messaggi esistente. È anche necessario specificare il parametro Locale. Il parametro Identity può utilizzare un valore di stringa, ossia il valore del parametro Name di una classificazione dei messaggi esistente.
Locale	Obbligatorio	System.Globalization.CultureInfo	Specificando un codice di lingua per il parametro Locale si crea una versione specifica locale della classificazione dei messaggi. Quando si crea una nuova versione specifica locale, è anche necessario inserire il parametro Identity della classificazione dei messaggi esistente predefinita. Input validi per il parametro Locale sono i nomi di stringhe elencati nella colonna Culture Name nel riferimento di classe Libreria di classi di Microsoft .NET disponibile all'indirizzo CultureInfo (informazioni in lingua inglese).
Name	Obbligatorio	System.String	Questo parametro consente di specificare il nome amministrativo per l'istanza di classificazione dei messaggi. Tale nome viene utilizzato per amministrare l'istanza di classificazione dei messaggi Quando si specifica un nome che include spazi, è necessario includere l'intero nome tra virgolette come indicato di seguito, ad esempio "Adminstrative Name". Il parametro Name non può contenere più di 256 caratteri.
SenderDescription	Obbligatorio	System.String	Questo parametro consente di fornire al mittente una descrizione dello scopo per cui è stata utilizzata una determinata classificazione dei messaggi. Il testo immesso in questo parametro viene utilizzato dagli utenti di Outlook per selezionare la classificazione dei messaggi appropriata prima di inviare un messaggio. Racchiudere la descrizione tra virgolette, come indicato di seguito, ad esempio, "This is the sender description that explains when to use this message classification". Il parametro SenderDescription non può contenere più di 1024 caratteri.
ClassificationID	Facoltativo	System.Guid	Questo parametro consente di specificare l'ID classificazione di una classificazione dei messaggi esistente che si desidera importare e utilizzare nella propria organizzazione di Exchange. Utilizzare questo parametro se si configurano classificazioni di messaggi che comprendono due foreste di Exchange nella stessa azienda.
Confirm	Facoltativo	System.Management.Automation.SwitchParameter	Il parametro Confirm determina l'interruzione dell'elaborazione e richiede che l'utente, prima che l'elaborazione continui, confermi l'operazione che verrà eseguita dal comando. Non è necessario specificare alcun valore con il parametro Confirm.
DomainController	Facoltativo	Microsoft.Exchange.Data.Fqdn	Per specificare il nome di dominio completo (FQDN) del controller di dominio che consente di scrivere le modifiche alla configurazione nel servizio directory di Active Directory, includere nel comando il parametro DomainController. Il parametro DomainController non è supportato nei computer in cui è installato il ruolo del server Trasporto Edge. Il ruolo del server Trasporto Edge prevede solo la scrittura e la lettura nell'istanza locale Active Directory Application Mode (ADAM).
RecipientDescription	Facoltativo	System.String	Questo parametro consente di spiegare al destinatario lo scopo della classificazione dei messaggi. Il testo immesso in questo parametro viene utilizzato dagli utenti di Outlook quando ricevono un messaggio incluso in questa classificazione dei messaggi. Racchiudere la descrizione tra virgolette, come indicato di seguito, ad esempio, "This is the recipient description that explains how to treat the message that has been classified". Il parametro RecipientDescription non può contenere più di 1024 caratteri. Se per questo parametro non si immette nessun valore, viene utilizzata la descrizione immessa per il parametro SenderDescription.
TemplateInstance	Facoltativo	System.Management.Automation.PSObject	Quando per il parametro TemplateInstance viene specificato un oggetto esistente, il comando utilizza la configurazione dell'oggetto per creare una copia identica dell'oggetto in un server locale o di destinazione.
UserDisplayEnabled	Facoltativo	System.Boolean	Questo parametro consente di specificare se i valori immessi per i parametri DisplayName e RecipientDescription dovranno essere visualizzati nel messaggio di Outlook del destinatario. Se si imposta il parametro UserDisplayEnabled su $false, i messaggi inviati ai destinatari e appartenenti a questa classificazione dei messaggi non visualizzano nessuna informazione di classificazione. Il valore predefinito è $true.
Confirm	Facoltativo	System.Management.Automation.SwitchParameter	Il parametro Confirm determina l'interruzione dell'elaborazione e richiede che l'utente, prima che l'elaborazione continui, confermi l'operazione che verrà eseguita dal comando. Non è necessario specificare alcun valore con il parametro Confirm.
WhatIf	Facoltativo	System.Management.Automation.SwitchParameter	Il parametro WhatIf consente al comando di simulare le azioni da intraprendere sull'oggetto. Utilizzando il parametro WhatIf, è possibile visualizzare quali sono le modifiche che verrebbero apportate senza applicarle. Non è necessario specificare alcun valore con il parametro WhatIf.

Esempio

Il campione di codice seguente mostra tre esempi che utilizzano il cmdlet New-MessageClassification.

Il primo esempio mostra il comando New-MessageClassification con i parametri richiesti.

Il secondo esempio mostra la procedura per la creazione di una versione specifica locale (Spagnola - Spagna) di una classificazione dei messaggi esistente.

Il terzo esempio mostra la procedura per la creazione di un'altra versione specifica locale (Spagnola - Messico) di una classificazione dei messaggi esistente.

New-MessageClassification -Name Example -DisplayName "New Message Classification" -SenderDescription "This is the description text"
New-MessageClassification -Identity Example -Locale es-ES -DisplayName "España Example " -SenderDescription "Este es el texto de la descripción"
New-MessageClassification -Identity Example -Locale es-MX -DisplayName "México Example" -SenderDescription "Este es el texto de la descripción"