New-MessageClassification
內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 某些參數和設定可能專屬於一個環境或另一個環境。
使用 New-MessageClassification Cmdlet 在您的組織中建立訊息分類實例。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
語法
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>]
Description
建立新的訊息分類之後,您可以將訊息分類指定為傳輸規則述詞。 在Microsoft Outlook 和 Outlook 網頁版 使用者可以將訊息分類套用至訊息之前,您必須使用 Export-OutlookClassification.ps1 腳本檔案所建立的訊息分類 XML 檔案來更新用戶系統。 Export-OutlookClassification.ps1 文稿檔案位於 %ExchangeInstallPath%Scripts 目錄中。
當您建立訊息分類時,它沒有任何地區設定。 根據預設,新的訊息分類會用於所有地區設定。 定義預設訊息分類之後,您可以執行 New-MessageClassification Cmdlet,並指定要本地化的預設訊息分類身分識別,以新增分類的地區設定。
您必須已獲指派權限,才能執行此指令程式。 雖然本文列出 Cmdlet 的所有參數,但如果某些參數未包含在指派給您的許可權中,您可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
New-MessageClassification -Name "My Message Classification" -DisplayName "New Message Classification" -SenderDescription "This is the description text"
此範例會使用下列屬性建立名為「我的訊息分類」的訊息分類:
- 顯示名稱是 [新增訊息分類]。
- 寄件者描述為「這是描述文字」。
範例 2
New-MessageClassification -Name "My Message Classification" -Locale es-ES -DisplayName "España Example" -SenderDescription "Este es el texto de la descripción"
在內部部署 Exchange 中,此範例會建立地區設定特定的 (西班牙文 - 西班牙) 名為「我的郵件分類」的現有訊息分類版本。
參數
-ClassificationID
適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online
ClassificationID 參數會指定您想要在 Exchange 組織中匯入和使用之現有訊息分類的分類標識碼 (GUID) 。 如果您要設定跨相同組織中兩個 Exchange 樹系的訊息分類,請使用此參數。
若要尋找訊息分類的 ClassificationID 值,請將 取代 <MessageClassificationName> 為訊息分類的名稱,然後執行下列命令: Get-MessageClassification -Identity "<MessageClassificationName>"。
參數屬性
| 類型: | Guid |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Confirm
適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online
Confirm 參數會指定要顯示或隱藏確認提示。 這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。
- 破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停,它會先強迫您確認命令才會繼續作業。 對於這些 Cmdlet,您可以使用以下確切語法來略過確認提示:
-Confirm:$false。 - 其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。 在使用這些 Cmdlet 時,指定不含任何值的 Confirm 參數會引入強迫您認可命令後才繼續作業的暫停。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | cf |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DisplayName
適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online
DisplayName 參數會指定在 Outlook 中顯示並由使用者選取的訊息分類標題。 最大長度為 256 個字元。 如果值包含空格,請使用引號 (") 括住值。
訊息分類 XML 檔案必須存在於寄件者的電腦上,才能顯示顯示名稱。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DisplayPrecedence
適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online
DisplayPrecedence 參數會指定訊息分類與其他可能套用至指定訊息之訊息分類的相對優先順序。 有效值為:
- 最高
- 較高
- 高
- MediumHigh
- 中 (預設值)
- MediumLow
- 低
- 較低
- 最低
雖然 Outlook 只讓使用者指定郵件的單一分類,但傳輸規則可能會將其他分類套用至訊息。 優先順序最高的分類會先顯示,而後續的分類會依此參數所定義的較低優先順序,依之後的適當順序附加。
參數屬性
| 類型: | ClassificationDisplayPrecedenceLevel |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DomainController
適用:Exchange Server 2010 年、Exchange Server 2013 年 Exchange Server 2016 年 Exchange Server 2019 年
此參數僅適用於內部部署 Exchange。
DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如,dc01.contoso.com。
Edge Transport Server 不支援 DomainController 參數。 Edge Transport Server 會使用 Active Directory 輕量型目錄服務 (AD LDS) 的本機執行個體來讀寫資料。
參數屬性
| 類型: | Fqdn |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Locale
適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online
此參數可在內部部署 Exchange 中運作。
Locale 參數會指定現有訊息分類的地區設定特定版本。 您可以使用 -Name 參數來識別現有的訊息分類,並使用 SenderDescription 參數來指定另一種語言的描述性文字。
此參數的有效值是 Microsoft .NET Framework CultureInfo 類別 (支援的文化特性代碼值,例如丹麥文的 da-DK 或日文) 的 ja-JP。 如需詳細資訊,請參閱 CultureInfo 類別。
參數屬性
| 類型: | CultureInfo |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Localized
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Name
適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online
Name 參數會指定訊息分類的唯一名稱。 最大長度為 64 個字元。 如果值包含空格,請使用引號 (") 括住值。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PermissionMenuVisible
適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online
PermissionMenuVisible 參數會指定當使用者撰寫訊息時,是否要在 Outlook 中顯示您為 DisplayName 和 RecipientDescription 參數輸入的值。 有效值為:
- $true:用戶可以在訊息傳送之前將訊息分類指派給訊息,並顯示分類資訊。 此值為預設值。
- $false:用戶無法在訊息傳送之前將訊息分類指派給訊息,不過,使用此訊息分類接收的訊息仍會顯示分類資訊。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RecipientDescription
適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online
RecipientDescription 參數會指定當 Outlook 收件者收到已套用郵件分類的郵件時,所顯示的詳細文字。 最大長度為 1024 個字元。 如果值包含空格,請使用引號 (") 括住值。
如果您未使用此參數,則會使用 SenderDescription 參數的值。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RetainClassificationEnabled
適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online
RetainClassificationEnabled 參數會指定如果要轉寄或回復訊息,訊息分類是否應與訊息一起保存。
預設值為 $true。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SenderDescription
適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online
SenderDescription 參數會指定當 Outlook 發件人選取要在傳送郵件之前套用至郵件的郵件分類時,所顯示的詳細文字。 最大長度為 1024 個字元。 如果值包含空格,請使用引號 (") 括住值。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online
WhatIf 參數會模擬命令的動作。 使用此參數時,您不需要實際套用變更即可檢視可能會發生的變更。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 無線 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。
輸入
Input types
若要查看此指令程式可接受的輸入類型,請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的,表示指令程式不接受輸入資料。
輸出
Output types
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。