共用方式為


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

若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。