New-ManagedContentSettings
此 Cmdlet 僅適用於 2010 Exchange Server。
使用 New-ManagedContentSettings Cmdlet 來建立受控資料夾的受控內容設定。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
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 的所有參數,但如果某些參數未包含在指派給您的許可權中,您可能無法存取這些參數。 若要尋找在組織中執行任何 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
適用:Exchange Server 2010 年
AddressForJournaling 參數會指定要傳送日誌郵件的日誌收件者。 您可以使用唯一識別收件者的任何值。 例如:
- 名稱
- 別名
- 辨別名稱 (DN)
- 辨別名稱 (DN)
- 標準 DN
- GUID
如果 JournalingEnabled 參數設定為 $true,則需要此參數。
參數屬性
| 類型: | RecipientIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-AgeLimitForRetention
適用:Exchange Server 2010 年
AgeLimitForRetention 參數會指定項目強制保留的存留期。 保留限制會對應到項目傳遞日起算的天數;若未傳遞,則對應到建立項目的日期。 如果沒有此參數,而且 RetentionEnabled 參數設為 $true,則會傳回錯誤。
參數屬性
| 類型: | EnhancedTimeSpan |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Confirm
適用:Exchange Server 2010 年
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 |
-DomainController
適用:Exchange Server 2010 年
DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如,dc01.contoso.com。
參數屬性
| 類型: | Fqdn |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-FolderName
適用:Exchange Server 2010 年
FolderName 參數會指定受控內容設定所套用之受管理資料夾的名稱或 GUID。
參數屬性
| 類型: | ELCFolderIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-JournalingEnabled
適用:Exchange Server 2010 年
JournalingEnabled 參數會指定將 設為 $true 時啟用日誌記錄。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-LabelForJournaling
適用:Exchange Server 2010 年
LabelForJournaling 參數會指定附加至專案的標籤。 目的地存放區會使用此標籤來判斷項目的內容,並強制執行適當的原則。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-MessageClass
適用:Exchange Server 2010 年
MessageClass 參數會指定要套用這些內容設定內任何到期和日誌設定的訊息類型。
參數值可以是已知的訊息類型,例如行事曆專案、IPM 等特定訊息類別。注意。SMIME 或自定義訊息類別。 您可以使用下列已知訊息類型:
- 針對 [所有信箱內容],請使用 *值。
- 針對 [行事曆專案] 訊息類型,請使用值 IPM。約會*。
- 針對 [連絡人] 訊息類型,請使用值 IPM。聯繫*。
- 針對 [檔案] 訊息類型,請使用值 IPM。公文*。
- 針對 [傳真] 訊息類型,請使用值 IPM。Note.Microsoft.Fax。
- 針對 Journalitems 訊息類型,請使用值 IPM。活動。
- 針對 [會議要求、回應和取消] 訊息類型,請使用值 IPM。附表*。
- 針對 Notes 訊息類型,請使用值 IPM。StickyNote。
- 針對 [貼文] 訊息類型,請使用值 IPM.Post。
- 針對 RSS 專案訊息類型,請使用值 IPM。Post.RSS。
- 針對 [工作] 訊息類型,請使用值 IPM。任務*。
- 針對語音信箱訊息類型,請使用值 IPM。Note.Microsoft.Voicemail*.
自訂訊息類別的有效參數值包括:
- 特定訊息類別 (例如 IPM。注意) 。
- 星號 (*) 通配符,表示內容設定適用於所有訊息類別。
- 具有星號通配符的特定訊息類別。 星號通配符必須顯示為訊息類別中的最後一個字元。 例如,IPM。注意* (包含 IPM。附註和所有子類別) 或 IPM。注意.* (包含 IPM 的子類別。注意,但不是 IPM。請注意本身) 。 *.附注和 IPM.*。注意 不是有效的值。
附註:
- 使用通配符時,這些原則僅適用於沒有特定內容設定的訊息類別。 因此,IPM。注意。SMIME 會覆寫 IPM。注意。*。
- 特定設定取代一般設定,例如語音信箱取代 AllMailboxContent。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-MessageFormatForJournaling
適用:Exchange Server 2010 年
MessageFormatForJournaling 參數會指定項目應該以日誌記錄的訊息格式。 您可以使用下列值:
- UseMsg Outlook .msg格式
- UseTnef Outlook MAPI 格式
參數屬性
| 類型: | JournalingFormat |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-MoveToDestinationFolder
適用:Exchange Server 2010 年
MoveToDestinationFolder 參數會指定移動動作的目的地資料夾。
目的地資料夾必須是現有的受控自定義資料夾。 如果不是,則會傳回錯誤。 如果MoveToDestinationFolder 參數不存在,且 RetentionAction 參數的值為MoveToFolder,則會傳回錯誤。
參數屬性
| 類型: | ELCFolderIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Name
適用:Exchange Server 2010 年
Name 參數會指定受管理的內容設定的唯一名稱。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RetentionAction
適用:Exchange Server 2010 年
RetentionAction 參數會指定下列其中一個動作:
- 標記為超過保留限制
- 移到受管理的自訂資料夾
- 移到 [刪除的郵件] 資料夾
- 刪除並允許復原
- 永久刪除
如果沒有此參數,而且 RetentionEnabled 參數設為 $true,則會傳回錯誤。
參數屬性
| 類型: | RetentionAction |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RetentionEnabled
適用:Exchange Server 2010 年
RetentionEnabled 參數會指定將 設為 $true 時啟用保留。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-TriggerForRetention
適用:Exchange Server 2010 年
TriggerForRetention 參數會指定視為保留期間開始日期的日期。 在傳遞專案或移至資料夾之後,專案可以達到其保留限制的特定天數。
有效值包括:
- WhenDelivered
- WhenMoved
此值會對應至 Active Directory 中 msExchELCFlags 屬性的0x4位。 如果專案根據移動的日期到期,則旗標會設定為 $true,如果專案根據傳遞日期過期,則會$false。
如果沒有此參數,而且 RetentionEnabled 參數設為 $true,則會傳回錯誤。
參數屬性
| 類型: | RetentionDateType |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
適用:Exchange Server 2010 年
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
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。