New-MessageClassification (RTM)

適用版本： Exchange Server 2007

上次修改主題的時間： 2007-06-08

使用 New-MessageClassification 指令程式可在 Exchange 組織中建立新的郵件分類執行個體。建立新的郵件分類後，可以將該郵件分類指定成傳輸規則述詞。您必須先使用由 Export-OutlookClassification.ps1 指令碼檔案所建立的郵件分類 XML 檔案來更新使用者系統後，Microsoft Office Outlook 2007 及 Outlook Web Access 2007 使用者才可以對郵件套用郵件分類。Export-OutlookClassification.ps1 指令碼檔案位於 \Program Files\Microsoft\Exchange Server\Scripts 目錄中。

建立新的郵件分類時，不會有任何地區設定。新的郵件分類預設將用於所有地區設定。定義預設郵件分類後，可以執行 New-MessageClassification 指令程式並指定想要當地語系化之預設郵件分類識別碼，來新增分類地區設定。

語法

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

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

詳細描述

若要執行 New-MessageClassification 指令程式，必須對您使用的帳戶委派下列項目：

• Exchange 組織系統管理員角色

如需管理 Microsoft Exchange Server 2007 所需之權限、委派角色及權利的相關資訊，請參閱權限考量。

參數

參數	必要	類型	描述
DisplayName	必要	System.String	使用 DisplayName 參數可指定郵件分類執行個體的顯示名稱。顯示名稱會出現在 Office 2007 中，而且 Outlook 使用者會在傳送郵件之前用它來選取適當的郵件分類。 附註： 郵件分類 XML 檔案必須存在於寄件者的電腦上，才能顯示顯示名稱。 如果 UserDisplayEnabled 參數設為 $true，則即使未安裝郵件分類 XML 檔案，仍會向收件者顯示名稱。 指定含有空格的名稱時，您必須如下所示用雙引號括住整個名稱 (例如，"Display Name")。DisplayName 參數必須包含 64 個以內的字元。
Identity	必要	Microsoft.Exchange.Configuration.Tasks.MessageClassificationIdParameter	使用此參數可建立現有郵件分類的翻譯版本。也必須指定 Locale 參數。Identity 參數可以是字串值，也就是現有郵件分類的 Name 值。
Locale	必要	System.Globalization.CultureInfo	指定文化代碼作為 Locale 參數會建立地區設定特有的郵件分類版本。建立新地區設定特有的版本時，也必須傳遞預設現有郵件分類的 Identity 參數。 Locale 參數的有效輸入是列在 Microsoft .NET 類別庫類別參考資料＜CultureInfo 類別＞(英文) 中之「文化名稱」欄位內的字串名稱。
Name	必要	System.String	使用此參數可指定郵件分類執行個體的管理名稱。該名稱用來管理郵件分類執行個體。指定含有空格的名稱時，您必須如下所示用雙引號括住整個名稱 (例如，"Adminstrative Name")。Name 參數必須包含 256 個以內的字元。
SenderDescription	必要	System.String	使用此參數可向寄件者說明會達成何種郵件分類。在此參數中輸入的文字是讓 Outlook 使用者在傳送郵件之前用來選取適當的郵件分類。請以引號括住說明，如下例所示："This is the sender description that explains when to use this message classification"。SenderDescription 參數必須包含 1024 個以內的字元。
ClassificationID	選用	System.Guid	使用此參數可指定想要匯入並用於 Exchange 組織中之現有郵件分類的分類識別碼。如果設定的郵件分類需要橫跨相同企業中的兩個 Exchange 樹系，請使用此參數。
DomainController	選用	Microsoft.Exchange.Data.Fqdn	若要指定將此組態變更寫入至 Active Directory 目錄服務之網域控制站的網域全名，請在命令中加入 DomainController 參數。已安裝 Edge Transport server role 的電腦不支援 DomainController 參數。Edge Transport server role 只會讀取和寫入至本機 Active Directory 應用程式模式 (ADAM) 執行個體。
RecipientDescription	選用	System.String	使用此參數可向收件者說明達成何種郵件分類。Outlook 使用者在接收具有此郵件分類的郵件時會看見此參數中所輸入的文字。請以引號括住說明，如下例所示："This is the recipient description that explains how to treat the message that has been classified"。RecipientDescription 參數必須包含 1024 個以內的字元。 如果未輸入此參數的值，則會使用您為 SenderDescription 所輸入的說明。
TemplateInstance	選用	System.Management.Automation.PSObject	將現有的物件提供給 TemplateInstance 參數時，命令會使用該物件的組態在本機或目標伺服器上建立該物件的相同複本。
UserDisplayEnabled	選用	System.Boolean	使用此參數可指定在 DisplayName 及 RecipientDescription 參數中輸入的值是否會顯示在收件者的 Outlook 郵件中。 如果將 UserDisplayEnabled 參數設為 $false，則傳送給收件者而且具有此郵件分類的郵件不會顯示任何分類資訊。 預設值為 $true。

範例

下列程式碼範例顯示三個使用 New-MessageClassification 指令程式的範例。

第一個範例顯示含有必要參數的 New-MessageClassification 命令。

第二個範例顯示如何建立現有郵件分類的地區設定特有 (西班牙文 - 西班牙) 版本。

第三個範例顯示如何建立現有郵件分類的另一個地區設定特有 (西班牙文 - 墨西哥) 版本。

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"