New-MessageClassification
Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni potrebbero essere esclusivi per un ambiente o l'altro.
Utilizzare il cmdlet New-MessageClassification per creare una nuova istanza di classificazione dei messaggi nell'organizzazione.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Localized
New-MessageClassification
[-Name] <String>
-DisplayName <String>
-Locale <CultureInfo>
-SenderDescription <String>
[-Confirm]
[-DomainController <Fqdn>]
[-RecipientDescription <String>]
[-WhatIf]
[<CommonParameters>]
Identity
New-MessageClassification
[-Name] <String>
-DisplayName <String>
-SenderDescription <String>
[-ClassificationID <Guid>]
[-Confirm]
[-DisplayPrecedence <ClassificationDisplayPrecedenceLevel>]
[-DomainController <Fqdn>]
[-PermissionMenuVisible <Boolean>]
[-RecipientDescription <String>]
[-RetainClassificationEnabled <Boolean>]
[-WhatIf]
[<CommonParameters>]
Descrizione
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 Outlook e Outlook sul web possano applicare la classificazione dei messaggi ai messaggi, è necessario aggiornare i sistemi degli utenti finali con il file XML di classificazione dei messaggi creato dal file di script Export-OutlookClassification.ps1. Il file script Export-OutlookClassification.ps1 si trova nella directory, %ExchangeInstallPath%Scripts,
Quando si crea una classificazione dei messaggi, essa non è associata ad alcuna impostazione locale. 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.
È 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-MessageClassification -Name "My Message Classification" -DisplayName "New Message Classification" -SenderDescription "This is the description text"
In questo esempio viene creata la classificazione dei messaggi denominata My Message Classification con le proprietà seguenti:
- Il nome visualizzato è New Message Classification.
- La descrizione del mittente è "This is the description text".
Esempio 2
New-MessageClassification -Name "My Message Classification" -Locale es-ES -DisplayName "España Example" -SenderDescription "Este es el texto de la descripción"
In Exchange locale questo esempio crea una versione specifica delle impostazioni locali (Spagnolo - Spagna) di una classificazione di messaggi esistente denominata "My Message Classification".
Parametri
-ClassificationID
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
Il parametro ClassificationID specifica l'ID di classificazione (GUID) di una classificazione di messaggi esistente che si desidera importare e usare nell'organizzazione di Exchange. Usare questo parametro se si configurano classificazioni di messaggi che si estendono su due foreste di Exchange nella stessa organizzazione.
Per trovare il valore ClassificationID della classificazione dei messaggi, sostituire <MessageClassificationName> con il nome della classificazione dei messaggi ed eseguire il comando seguente: Get-MessageClassification -Identity "<MessageClassificationName>".
Proprietà dei parametri
| Tipo: | Guid |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Identity
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Confirm
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
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 |
-DisplayName
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
Il parametro DisplayName consente di specificare il titolo della classificazione dei messaggi visualizzata in Outlook e selezionata dagli utenti. La lunghezza massima è 256 caratteri. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
Perché il nome da visualizzare venga visualizzato, è necessario che il file XML di classificazione dei messaggi sia presente sul computer del mittente.
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 |
-DisplayPrecedence
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
Il parametro DisplayPrecedence consente di specificare la precedenza relativa della classificazione dei messaggi rispetto ad altre classificazioni di messaggi che potrebbero essere applicate a un messaggio specificato. I valori validi sono:
- Highest
- Higher
- Fortemente
- MediaAperta
- Medio (valore predefinito)
- MediumLow
- Bassa
- Lower
- Lowest
Anche se Outlook consente solo a un utente di specificare una singola classificazione per un messaggio, le regole di trasporto potrebbero applicare altre classificazioni a un messaggio. La classificazione con la precedenza più alta viene visualizzata per prima e le classificazioni successive, ovvero quelle con precedenza minore definite da questo parametro, vengono successivamente aggiunte nell'ordine appropriato.
Proprietà dei parametri
| Tipo: | ClassificationDisplayPrecedenceLevel |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Identity
| 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
Questo parametro è disponibile solo in Exchange locale.
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 |
-Locale
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
Questo parametro funziona in in Exchange locale.
Il parametro Locale consente di specificare una versione specifica delle impostazioni locali di una classificazione dei messaggi esistente. Usare il parametro -Name per identificare la classificazione dei messaggi esistente e il parametro SenderDescription per specificare il testo descrittivo in un'altra lingua.
Un valore valido per questo parametro è un valore di codice delle impostazioni cultura supportato dalla classe CultureInfo di Microsoft .NET Framework, ad esempio da-DK per il danese o ja-JP per il giapponese. Per altre informazioni, vedere Classe CultureInfo.
Proprietà dei parametri
| Tipo: | CultureInfo |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Localized
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Name
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
Il parametro Name consente di specificare il nome univoco per la classificazione dei messaggi. La lunghezza massima è 64 caratteri. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 1 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-PermissionMenuVisible
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
Il parametro PermissionMenuVisible specifica se i valori immessi per i parametri DisplayName e RecipientDescription vengono visualizzati in Outlook quando l'utente compone un messaggio. I valori validi sono:
- $true: gli utenti possono assegnare la classificazione dei messaggi ai messaggi prima che vengano inviati e le informazioni di classificazione vengono visualizzate. Questo valore è il valore predefinito.
- $false: gli utenti non possono assegnare la classificazione dei messaggi ai messaggi prima che vengano inviati. Tuttavia, i messaggi ricevuti con questa classificazione dei messaggi visualizzano comunque le informazioni di classificazione.
Proprietà dei parametri
| Tipo: | Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Identity
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-RecipientDescription
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
Il parametro RecipientDescription consente di specificare il testo dettagliato visualizzato al destinatario di Outlook quando riceve un messaggio a cui è applicata la classificazione dei messaggi. La lunghezza massima è di 1024 caratteri. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
Se non si usa questo parametro, viene usato il valore del parametro SenderDescription.
Proprietà dei parametri
| Tipo: | String |
| 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 |
-RetainClassificationEnabled
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
Il parametro RetainClassificationEnabled consente di specificare se la classificazione dei messaggi deve essere mantenuta in caso di operazioni di inoltro o di risposta al messaggio.
Il valore predefinito è $true.
Proprietà dei parametri
| Tipo: | Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Identity
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-SenderDescription
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
Il parametro SenderDescription consente di specificare il testo dettagliato visualizzato ai mittenti di Outlook quando selezionano una classificazione dei messaggi da applicare a un messaggio prima di inviare il messaggio. La lunghezza massima è di 1024 caratteri. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
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, Exchange Online
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.