Set-MessageClassification (RTM)

 

適用版本: Exchange Server 2007

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

使用 Set-MessageClassification 指令程式,可設定 Exchange 組織中的現有郵件分類執行個體。

語法

Set-MessageClassification -Identity <MessageClassificationIdParameter> [-ClassificationID <Guid>] [-DisplayName <String>] [-DisplayPrecedence <Highest | Higher | High | MediumHigh | Medium | MediumLow | Low | Lower | Lowest>] [-DomainController <Fqdn>] [-Name <String>] [-RecipientDescription <String>] [-RetainClassificationEnabled <$true | $false>] [-SenderDescription <String>] [-UserDisplayEnabled <$true | $false>]

Set-MessageClassification [-ClassificationID <Guid>] [-DisplayName <String>] [-DisplayPrecedence <Highest | Higher | High | MediumHigh | Medium | MediumLow | Low | Lower | Lowest>] [-DomainController <Fqdn>] [-Instance <MessageClassification>] [-Name <String>] [-RecipientDescription <String>] [-RetainClassificationEnabled <$true | $false>] [-SenderDescription <String>] [-UserDisplayEnabled <$true | $false>]

詳細描述

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

  • Exchange 組織系統管理員角色

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

參數

參數 必要 類型 描述

Identity

必要

Microsoft.Exchange.Configuration.Tasks.MessageClassificationIdParameter

Identity 參數可以是字串值,也就是 Name 值或 GUID。

ClassificationID

選用

System.Guid

使用此參數指定要在您的 Exchange 組織中使用之現有郵件分類的 GUID。若您要設定郵件分類以在相同的組織中跨兩個 Exchange 樹系,則使用此參數。

DisplayName

選用

System.String

使用此參數來指定郵件分類執行個體的顯示名稱。此顯示名稱會出現在 Microsoft Office 2007 並由 Microsoft Outlook 使用者所使用,以在他們傳送郵件之前先選取適當的郵件分類。

指定含有空格的名稱時,您必須如下所示用雙引號括住整個名稱 (例如,"Display Name")。DisplayName 參數必須包含 64 個以內的字元。

DisplayPrecedence

選用

Microsoft.Exchange.Data.Directory.SystemConfiguration.ClassificationDisplayPrecedenceLevel

使用此參數來指定此郵件分類,相對於其他可套用至指定郵件之郵件分類的優先順序。雖然 Outlook 只能讓使用者在指定郵件上指定單一分類,但傳輸規則可以套用其他的分類。此參數會在指定的分類上設定優先,以決定在 Outlook 中如何顯示給收件者。具有最高優先的分類會先顯示,而由此參數定義為次要優先的後續分類會以適當順序附加於後。

DisplayPrecedence 參數的有效輸入是 HighestHigherHighMediumHighMediumMediumLowLowLower,以及 Lowest

預設值為 Mediuum

DomainController

選用

Microsoft.Exchange.Data.Fqdn

若要指定將此組態變更寫入至 Active Directory 目錄服務之網域控制站的網域全名 (FQDN),請在命令中加入 DomainController 參數。已安裝 Edge Transport server role 的電腦不支援 DomainController 參數。Edge Transport server role 只會讀取和寫入至本機 Active Directory 應用程式模式 (ADAM) 執行個體。

Instance

選用

Microsoft.Exchange.Data.Directory.SystemConfiguration.MessageClassification

使用此參數可將整個物件傳遞至要處理的命令。此參數主要是用於必須將整個物件傳遞給命令的指令碼。

Name

選用

System.String

使用此參數可指定郵件分類執行個體的管理名稱。該名稱用來管理郵件分類執行個體。指定含有空格的名稱時,您必須如下所示用雙引號括住整個名稱 (例如,"Adminstrative Name")。Name 參數必須包含 256 個以內的字元。

RecipientDescription

選用

System.String

使用此參數可向收件者說明達成何種郵件分類。當 Outlook 使用者收到具有此郵件分類的郵件時,可以檢視您在此參數中輸入的文字。請以引號括住說明,如下例所示:"This is the recipient description that explains how to treat the message that has been classified"RecipientDescription 參數必須包含 1024 個以內的字元。

如果未輸入此參數的值,則會使用您為 SenderDescription 所輸入的說明。

RetainClassificationEnabled

選用

System.Boolean

使用此參數來指定在轉寄或回覆郵件時,郵件分類是否仍持續存在郵件中。

預設值為 $true

SenderDescription

選用

System.String

使用此參數可向寄件者說明會達成何種郵件分類。您在此參數中輸入的文字會由 Outlook 使用者使用,以在他們傳送郵件之前先選取適當的郵件分類。請以引號括住說明,如下例所示:"This is the sender description that explains when to use this message classification"SenderDescription 參數必須包含 1024 個以內的字元。

UserDisplayEnabled

選用

System.Boolean

UserDisplayEnabled 參數設定為 $true,則會對以此郵件分類傳送的郵件收件者,顯示您在 DisplayNameRecipientDescription 參數中所輸入的文字。

預設值為 $true

範例

下列程式碼範例會將機密保護動作設定為 "None",並將 Identity 參數為 "Example" 之郵件分類執行個體的顯示優先設為 "false"。也會指定在轉寄或回覆郵件時,郵件分類不會持續存在郵件中。

Set-MessageClassification -Identity Example -ConfidentialityAction None -DisplayPrecedence -RetainClassificationEnabled: $false