New-MessageClassification
Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.
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
New-MessageClassification
[-Name] <String>
-DisplayName <String>
-Locale <CultureInfo>
-SenderDescription <String>
[-Confirm]
[-DomainController <Fqdn>]
[-RecipientDescription <String>]
[-WhatIf]
[<CommonParameters>] 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 di Microsoft gli utenti di Outlook e Outlook sul web possono 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. 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
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
Il parametro ClassificationID consente di specificare l'ID di classificazione (GUID) di una classificazione dei 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>".
| Type: | Guid |
| 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, Exchange Online |
-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, Exchange Online |
-DisplayName
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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DisplayPrecedence
Il parametro DisplayPrecedence consente di specificare la priorità della classificazione del messaggio rispetto ad altre classificazioni applicabili a un determinato messaggio. I valori validi sono:
- Highest
- Higher
- Fortemente
- MediaAperta
- Medio (questo è il 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 possono 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.
| Type: | ClassificationDisplayPrecedenceLevel |
| 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, Exchange Online |
-DomainController
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.
| 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 |
-Locale
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 Microsoft .NET Framework, ad esempio da-DK per danese o ja-JP per il giapponese. Per altre informazioni, vedere Classe CultureInfo.
| Type: | CultureInfo |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Name
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 (").
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-PermissionMenuVisible
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 dell'invio e visualizzare le informazioni di classificazione. Questo è 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.
| Type: | Boolean |
| 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, Exchange Online |
-RecipientDescription
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.
| 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, Exchange Online |
-RetainClassificationEnabled
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.
| Type: | Boolean |
| 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, Exchange Online |
-SenderDescription
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 (").
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-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, Exchange Online |
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.