New-ManagedContentSettings
此 Cmdlet 僅適用于 2010 Exchange Server。
使用 New-ManagedContentSettings Cmdlet 來建立受控資料夾的受控內容設定。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
Syntax
New-ManagedContentSettings
[-Name] <String>
-FolderName <ELCFolderIdParameter>
-MessageClass <String>
[-AddressForJournaling <RecipientIdParameter>]
[-AgeLimitForRetention <EnhancedTimeSpan>]
[-Confirm]
[-DomainController <Fqdn>]
[-JournalingEnabled <Boolean>]
[-LabelForJournaling <String>]
[-MessageFormatForJournaling <JournalingFormat>]
[-MoveToDestinationFolder <ELCFolderIdParameter>]
[-RetentionAction <RetentionAction>]
[-RetentionEnabled <Boolean>]
[-TriggerForRetention <RetentionDateType>]
[-WhatIf]
[<CommonParameters>]
Description
受控內容設定是您與受控資料夾相關聯的設定,可控制使用者信箱中專案的存續期。 Lifespan 的控制方式如下:
- 藉由控制內容保留和移除不再需要的內容。
- 將重要內容自動記錄到信箱外部的個別儲存位置。
如需受控內容設定的詳細資訊,請參閱 傳訊記錄管理。
您必須已獲指派權限,才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數,不過,如果某些參數並未包含在指派給您的權限中,您可能就無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
New-ManagedContentSettings -Name "CS-Exec-DeletedItems" -FolderName "Exec-DeletedItems" -MessageClass * -RetentionEnabled $true -RetentionAction DeleteAndAllowRecovery -AgeLimitForRetention 30.00:00:00 -TriggerForRetention WhenDelivered
此範例會建立受控預設資料夾 Exec-DeletedItems 的受控內容設定。 當新增至受控資料夾信箱原則並套用至信箱時,[刪除的郵件] 資料夾中的專案將會從傳遞日期起的 30 天內永久刪除。
範例 2
New-ManagedContentSettings -Name CS-Exec-Calendar -FolderName Exec-Calendar -MessageClass Calendar -RetentionEnabled $true -RetentionAction MoveToDeletedItems -AgeLimitForRetention 180
此範例會建立 Calendar 訊息類別的 Managed 內容設定 CS-Exec-Calendar。 Managed 內容設定會套用至預設資料夾 Calendar。 保留已啟用,且專案會在 180 天后移至 [刪除的郵件] 資料夾。
參數
-AddressForJournaling
AddressForJournaling 參數會指定要傳送記錄郵件的日誌收件者。 您可以使用唯一識別收件者的任何值。 例如:
- 名稱
- 別名
- 辨別名稱 (DN)
- 辨別名稱 (DN)
- 標準 DN
- GUID
如果 JournalingEnabled 參數設定為 $true,則需要此參數。
Type: | RecipientIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-AgeLimitForRetention
AgeLimitForRetention 參數會指定項目強制保留的存留期。 保留限制會對應到項目傳遞日起算的天數;若未傳遞,則對應到建立項目的日期。 如果沒有此參數,而且 RetentionEnabled 參數設為 $true,則會傳回錯誤。
Type: | EnhancedTimeSpan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-Confirm
Confirm 參數會指定要顯示或隱藏確認提示。 這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。
- 例如,具破壞性的 Cmdlet (例如 Remove-* Cmdlet) 內建暫停,可強制您在繼續之前確認命令。 對於這些 Cmdlet,您可以使用以下確切語法來略過確認提示:
-Confirm:$false
。 - 其他大部分的 Cmdlet (例如,New-* 和 Set-* Cmdlet) 沒有內建暫停。 在使用這些 Cmdlet 時,指定不含任何值的 Confirm 參數會引入強迫您認可命令後才繼續作業的暫停。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-DomainController
DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如,dc01.contoso.com。
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-FolderName
FolderName 參數會指定受控內容設定所套用之受管理資料夾的名稱或 GUID。
Type: | ELCFolderIdParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-JournalingEnabled
JournalingEnabled 參數會指定將 設為 $true 時啟用日誌記錄。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-LabelForJournaling
LabelForJournaling 參數會指定附加至專案的標籤。 目的地存放區會使用此標籤來判斷專案的內容,並強制執行適當的原則。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-MessageClass
MessageClass 參數會指定要套用這些內容設定內任何到期和日誌設定的訊息類型。
參數值可以是已知的訊息類型,例如行事曆專案、特定訊息類別,例如 IPM。注意。SMIME 或自訂訊息類別。 您可以使用下列已知訊息類型:
- 針對 [所有信箱內容],請使用 *值。
- 針對 [行事曆專案] 訊息類型,請使用值 IPM。委任*。
- 針對 [連絡人] 訊息類型,請使用值 IPM。聯繫*。
- 針對 [檔] 訊息類型,請使用值 IPM。文檔*。
- 針對 [傳真] 訊息類型,請使用值 IPM。注意。Microsoft。傳真。
- 針對 Journalitems 訊息類型,請使用值 IPM。活動。
- 針對 [會議要求、回應和取消] 訊息類型,請使用值 IPM。附表*。
- 針對 Notes 訊息類型,請使用值 IPM。StickyNote。
- 針對 [貼文] 訊息類型,請使用值 IPM.Post。
- 針對 RSS 專案訊息類型,請使用值 IPM。Post.RSS。
- 針對 [工作] 訊息類型,請使用值 IPM。任務*。
- 針對語音信箱訊息類型,請使用值 IPM。注意。Microsoft。語音 信箱*。
自訂訊息類別的有效參數值包括:
- 特定訊息類別 (例如 IPM。注意) 。
- 星號 (*) 萬用字元,表示內容設定適用于所有訊息類別。
- 具有星號萬用字元的特定訊息類別。 星號萬用字元必須顯示為訊息類別中的最後一個字元。 例如,IPM。注意* (包含 IPM。附注和所有子類別) 或 IPM。注意.* (包含 IPM 的子類別。注意,但不是 IPM。請注意本身) 。 *.附注和 IPM.*。注意 不是有效的值。
附註:
- 使用萬用字元時,這些原則僅適用于沒有特定內容設定的訊息類別。 因此,IPM。注意。SMIME 會覆寫 IPM。注意。*。
- 特定設定取代一般設定,例如語音信箱取代 AllMailboxContent。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-MessageFormatForJournaling
MessageFormatForJournaling 參數會指定專案應該以日誌記錄的訊息格式。 您可以使用下列值:
- UseMsg Outlook .msg 格式
- UseTnef Outlook MAPI 格式
Type: | JournalingFormat |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-MoveToDestinationFolder
MoveToDestinationFolder 參數會指定移動動作的目的地資料夾。
目的地資料夾必須是現有的受控自訂資料夾。 如果不是,則會傳回錯誤。 如果 MoveToDestinationFolder 參數不存在,且 RetentionAction 參數的值為 MoveToFolder,則會傳回錯誤。
Type: | ELCFolderIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-Name
Name 參數會指定受管理的內容設定的唯一名稱。
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-RetentionAction
RetentionAction 參數會指定下列其中一個動作:
- 標記為超過保留限制
- 移到受管理的自訂資料夾
- 移到 [刪除的郵件] 資料夾
- 刪除並允許復原
- 永久刪除
如果沒有此參數,而且 RetentionEnabled 參數設為 $true,則會傳回錯誤。
Type: | RetentionAction |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-RetentionEnabled
RetentionEnabled 參數會指定將 設為 $true 時啟用保留。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-TriggerForRetention
TriggerForRetention 參數會指定視為保留期間開始日期的日期。 在傳遞專案或移至資料夾之後,專案可以達到其保留限制的特定天數。
有效值包括:
- WhenDelivered
- WhenMoved
此值會對應至 Active Directory 中 msExchELCFlags 屬性的0x4位。 如果專案會根據移動的日期到期,則旗標會設定為 $true,$false專案是否會根據傳遞日期過期。
如果沒有此參數,而且 RetentionEnabled 參數設為 $true,則會傳回錯誤。
Type: | RetentionDateType |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-WhatIf
WhatIf 參數會模擬命令的動作。 使用此參數時,您不需要實際套用變更即可檢視可能會發生的變更。 您不需要使用此參數指定值。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
輸入
Input types
若要查看此指令程式可接受的輸入類型,請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的,表示指令程式不接受輸入資料。
輸出
Output types
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。