You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@@ -39,42 +41,48 @@ This example lists all message classifications in your organization.
39
41
40
42
## PARAMETERS
41
43
42
-
### -DomainController
43
-
This parameter is available only in on-premises Exchange.
44
+
### -Identity
45
+
The Identity parameter specifies the message classification that you want to view. You can use any value that uniquely identifies the message classification. For example:
44
46
45
-
The DomainController parameter specifies the domain controller that's used by this cmdlet to read data from or write data to Active Directory. You identify the domain controller by its fully qualified domain name (FQDN). For example, dc01.contoso.com.
47
+
- Name
46
48
47
-
The DomainController parameter isn't supported on Edge Transport servers. An Edge Transport server uses the local instance of Active Directory Lightweight Directory Services (AD LDS) to read and write data.
49
+
- Identity: Default\\<Name\> or \<Locale\>\\<Name\>; for example, "Default\My Message Classification" or "es-ES\My Message Classification".
50
+
51
+
- ClassificationID (GUID)
48
52
49
53
```yaml
50
-
Type: Fqdn
54
+
Type: MessageClassificationIdParameter
51
55
Parameter Sets: (All)
52
56
Aliases:
53
-
Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
57
+
Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
54
58
Required: False
55
-
Position: Named
59
+
Position: 1
56
60
Default value: None
57
-
Accept pipeline input: False
61
+
Accept pipeline input: True
58
62
Accept wildcard characters: False
59
63
```
60
64
61
-
### -Identity
62
-
The Identity parameter specifies the name of the message classification instance that you want to view. When you specify a name that includes spaces, you must enclose the name in quotation marks ("), for example, "Administrative Name".
65
+
### -DomainController
66
+
This parameter is available only in on-premises Exchange.
67
+
68
+
The DomainController parameter specifies the domain controller that's used by this cmdlet to read data from or write data to Active Directory. You identify the domain controller by its fully qualified domain name (FQDN). For example, dc01.contoso.com.
69
+
70
+
The DomainController parameter isn't supported on Edge Transport servers. An Edge Transport server uses the local instance of Active Directory Lightweight Directory Services (AD LDS) to read and write data.
63
71
64
72
```yaml
65
-
Type: MessageClassificationIdParameter
73
+
Type: Fqdn
66
74
Parameter Sets: (All)
67
75
Aliases:
68
-
Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
76
+
Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
69
77
Required: False
70
-
Position: 1
78
+
Position: Named
71
79
Default value: None
72
-
Accept pipeline input: True
80
+
Accept pipeline input: False
73
81
Accept wildcard characters: False
74
82
```
75
83
76
84
### -IncludeLocales
77
-
The IncludeLocales switch specifies whether the command output includes the message classification locale data. When you use the IncludeLocales switch, the output includes the message classification locale data.
85
+
The IncludeLocales switch specifies whether to return message classification locale information in the results. You don't need to specify a value with this switch.
Copy file name to clipboardExpand all lines: exchange/exchange-ps/exchange/policy-and-compliance/New-MessageClassification.md
+52-34Lines changed: 52 additions & 34 deletions
Original file line number
Diff line number
Diff line change
@@ -53,53 +53,49 @@ You need to be assigned permissions before you can run this cmdlet. Although thi
53
53
54
54
### -------------------------- Example 1 --------------------------
55
55
```
56
-
New-MessageClassification -Name MyMessageClassification -DisplayName "New Message Classification" -SenderDescription "This is the description text"
56
+
New-MessageClassification -Name "My Message Classification" -DisplayName "New Message Classification" -SenderDescription "This is the description text"
57
57
```
58
58
59
-
This example creates the message classification named MyMessageClassification with the following properties:
59
+
This example creates the message classification named My Message Classification with the following properties:
60
60
61
61
- The display name is New Message Classification.
62
62
63
63
- The sender description is "This is the description text".
64
64
65
65
### -------------------------- Example 2 --------------------------
66
66
```
67
-
New-MessageClassification MyMessageClassification -Locale es-ES -DisplayName "España Example" -SenderDescription "Este es el texto de la descripción"
67
+
New-MessageClassification -Name "My Message Classification" -Locale es-ES -DisplayName "España Example" -SenderDescription "Este es el texto de la descripción"
68
68
```
69
69
70
-
This example creates a locale-specific (Spanish - Spain) version of an existing message classification MyMessageClassification.
70
+
In on-premises Exchange, this example creates a locale-specific (Spanish - Spain) version of an existing message classification named "My Message Classification".
71
71
72
72
## PARAMETERS
73
73
74
-
### -DisplayName
75
-
The DisplayName parameter specifies the display name for the message classification instance. The display name is used by Outlook users to select the appropriate message classification before they send a message.
76
-
77
-
The message classification XML file must be present on the sender's computer for the display name to be displayed.
78
-
79
-
If the UserDisplayEnabled parameter is set to $true, the display name is displayed for the recipient, even if no message classification XML file is installed.
80
-
81
-
When you specify a name that includes spaces, you must enclose the name in quotation marks ("), for example, "Display Name". The DisplayName parameter can contain a maximum of 64 characters.
74
+
### -Name
75
+
The Name parameter specifies the unique name for the message classification. The maximum length is 64 characters. If the value contains spaces, enclose the value in quotation marks (").
82
76
83
77
```yaml
84
78
Type: String
85
79
Parameter Sets: (All)
86
80
Aliases:
87
81
Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
88
82
Required: True
89
-
Position: Named
83
+
Position: 1
90
84
Default value: None
91
85
Accept pipeline input: False
92
86
Accept wildcard characters: False
93
87
```
94
88
95
-
### -Locale
96
-
The Locale parameter specifies a locale-specific version of the message classification. You must also pass the Identity parameter of the default existing message classification when you create a new locale-specific version.
89
+
### -DisplayName
90
+
The DisplayName parameter specifies the title of the message classification that's displayed in Outlook and selected by users. The maximum length is 256 characters. If the value contains spaces, enclose the value in quotation marks (").
97
91
98
-
Valid input for this parameter is a supported culture code value from the Microsoft .NET Framework CultureInfo class. For example, da-DK for Danish or ja-JP for Japanese. For more information, see CultureInfo Class (https://go.microsoft.com/fwlink/p/?linkId=184859).
92
+
The message classification XML file must be present on the sender's computer for the display name to be displayed.
93
+
94
+
If the UserDisplayEnabled parameter is set to $true, the value of this parameter is displayed for the recipient, even if no message classification XML file is installed.
99
95
100
96
```yaml
101
-
Type: CultureInfo
102
-
Parameter Sets: Localized
97
+
Type: String
98
+
Parameter Sets: (All)
103
99
Aliases:
104
100
Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
The Name parameter specifies the administrative name for the message classification instance. The name is used to administer the message classification instance. When you specify a name that includes spaces, you must enclose the name in quotation marks ("), for example, "Administrative Name". The Name parameter can contain a maximum of 256 characters.
108
+
### -Locale
109
+
This parameter is available or functional on in on-premises Exchange.
110
+
111
+
The Locale parameter specifies a locale-specific version of an existing message classification. You use the -Name parameter to identify the existing message classification, and the SenderDescription parameter to specify the descriptive text in another language.
112
+
113
+
A valid value for this parameter is a supported culture code value from the Microsoft .NET Framework CultureInfo class (for example, da-DK for Danish or ja-JP for Japanese). For more information, see CultureInfo Class (https://go.microsoft.com/fwlink/p/?linkId=184859).
114
114
115
115
```yaml
116
-
Type: String
117
-
Parameter Sets: (All)
116
+
Type: CultureInfo
117
+
Parameter Sets: Localized
118
118
Aliases:
119
-
Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
119
+
Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
120
120
Required: True
121
-
Position: 1
121
+
Position: Named
122
122
Default value: None
123
123
Accept pipeline input: False
124
124
Accept wildcard characters: False
125
125
```
126
126
127
127
### -SenderDescription
128
-
The SenderDescription parameter specifies the purpose of the message classification to the sender. The value of this parameter is used by Outlook users to select the appropriate message classification before they send a message. Enclose the value in quotation marks ("), for example, "This is the sender description that explains when to use this message classification". The SenderDescription parameter can contain a maximum of 1,024 characters.
128
+
The SenderDescription parameter specifies the the detailed text that's shown to Outlook senders when they select a message classification to apply to a message before they send the message. The maximum length is 1024 characters. If the value contains spaces, enclose the value in quotation marks (").
The ClassificationID parameter specifies a classification ID of an existing message classification that you want to import and use in your Exchange organization. Use this parameter if you're configuring message classifications that span two Exchange forests in the same enterprise.
143
+
The ClassificationID parameter specifies the classification ID (GUID) of an existing message classification that you want to import and use in your Exchange organization. Use this parameter if you're configuring message classifications that span two Exchange forests in the same organization.
144
+
145
+
To find the ClassificationID value of the message classification, replace \<MessageClassificationName\> with the name of the message classification and run the following command: Get-MessageCalssification -Identity "\<MessageClassificationName\>.
The DisplayPrecedence parameter specifies the relative precedence of the message classification to other message classifications that may be applied to a specified message. Although Outlook only lets a user specify a single classification per message, transport rules may apply other classifications to a message. The classification with the highest precedence is shown first and the subsequent classifications, which are those with lesser precedence as defined by this parameter, are appended in the appropriate order thereafter.
179
+
The DisplayPrecedence parameter specifies the relative precedence of the message classification to other message classifications that may be applied to a specified message. Valid values are:
178
180
179
-
Valid input for the DisplayPrecedence parameter is Highest, Higher, High, MediumHigh, Medium, MediumLow, Low, Lower and Lowest.
181
+
- Highest
180
182
181
-
The default value is Medium.
183
+
- Higher
184
+
185
+
- High
186
+
187
+
- MediumHigh
188
+
189
+
- Medium (This is the default value)
190
+
191
+
- MediumLow
192
+
193
+
- Low
194
+
195
+
- Lower
196
+
197
+
- Lowest
198
+
199
+
Although Outlook only lets a user specify a single classification for a message, transport rules may apply other classifications to a message. The classification with the highest precedence is shown first and the subsequent classifications, which are those with lesser precedence as defined by this parameter, are appended in the appropriate order thereafter.
182
200
183
201
```yaml
184
202
Type: Highest | Higher | High | MediumHigh | Medium | MediumLow | Low | Lower | Lowest
The PermissionMenuVisible parameter specifies whether the values that you entered for the DisplayName and RecipientDescription parameters are displayed in Outlook as the user composes a message.
233
+
The PermissionMenuVisible parameter specifies whether the values that you entered for the DisplayName and RecipientDescription parameters are displayed in Outlook as the user composes a message. Valid values are:
216
234
217
-
If you set the PermissionMenuVisible parameter to $false, users won't be able to assign this message classification to the messages they are composing. However, messages received with this message classification still display the classification information.
235
+
- $true: Users can assign the message classification to messages before they're sent, and the classification information is displayed. This is the default value.
218
236
219
-
The default value is $true.
237
+
- $false: Users can't assign the message classification to messages before they're sent, However, messages received with this message classification still display the classification information.
The RecipientDescription parameter specifies the purpose of the message classification to the recipient. The value of this parameter is shown to Outlook users when they receive a message that has this message classification. Enclose the value in quotation marks ("), for example, "This is the recipient description that explains how to treat the message that has been classified". The RecipientDescription parameter can contain a maximum of 1,024 characters.
252
+
The RecipientDescription parameter specifies the the detailed text that's shown to Outlook recipient when they receive a message that has the message classification applied. The maximum length is 1024 characters. If the value contains spaces, enclose the value in quotation marks (").
235
253
236
-
If you don't enter a value for this parameter, the description that you enter for the SenderDescription parameter is used.
254
+
If you don't use this parameter, the value of the SenderDescription parameter is used.
Remove-MessageClassification -Identity "My Message Classification"
37
38
```
38
39
39
-
This example removes the message classification named MyMessageClassification.
40
+
This example removes the message classification named "My Message Classification".
40
41
41
42
## PARAMETERS
42
43
43
44
### -Identity
44
-
The Identity parameter specifies the name of the message classification instance that you want to remove. When you specify a name that includes spaces, you must enclose the name in quotation marks ("), for example, "Administrative Name".
45
+
The Identity parameter specifies the message classification that you want to remove. You can use any value that uniquely identifies the message classification. For example:
46
+
47
+
- Name
48
+
49
+
- Identity: Default\\<Name\> or \<Locale\>\\<Name\>; for example, "Default\My Message Classification" or "es-ES\My Message Classification".
0 commit comments