New-ManagedContentSettings
このコマンドレットは Exchange Server 2010 でのみ使用可能です。
管理フォルダーに管理コンテンツ設定を作成するには、New-ManagedContentSettings コマンドレットを使用します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
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>]
説明
管理コンテンツ設定は、ユーザーのメールボックス内のアイテムの有効期間を制御するために管理フォルダーに関連付ける設定です。 有効期間は、次の方法で制御されます。
- コンテンツ保存期間を制御、および不要になったコンテンツを削除する方法。
- メールボックス外にある個別の格納場所に、重要なコンテンツを自動的にジャーナリングする方法。
マネージド コンテンツ設定の詳細については、「 メッセージング レコード管理」を参照してください。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 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 メッセージ クラスのマネージド コンテンツ設定 CS-Exec-Calendar を作成します。 マネージド コンテンツ設定は、既定のフォルダー Calendar に適用されます。 保持が有効になり、アイテムは 180 日後に [削除済みアイテム] フォルダーに移動されます。
パラメーター
-AddressForJournaling
AddressForJournaling パラメーターは、ジャーナル処理されたメッセージが送信されるジャーナル処理受信者を指定します。 受信者を一意に識別する任意の値を使用できます。 たとえば、次の値を使用できます。
- 名前
- Alias
- 識別名 (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 スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。
- 破壊的なコマンドレット (Remove-* コマンドレットなど) には、続行する前にコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$false
を使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (New-* コマンドレットや Set-* コマンドレットなど) には、一時停止が組み込まれています。 これらのコマンドレットの場合、値なしで 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 パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは 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.Appointment* を使用します。
- 連絡先 メッセージ タイプの場合は、値 IPM.Contact* を使用します。
- ドキュメント メッセージ タイプの場合は、値 IPM.Document* を使用します。
- FAX メッセージ タイプの場合は、値 IPM.Note.Microsoft.Fax を使用します。
- ジャーナルアイテム メッセージ タイプの場合は、値 IPM.Activity を使用します。
- 会議出席依頼、返信、およびキャンセル メッセージ タイプの場合、値 IPM.Schedule* を使用します。
- メモ メッセージ タイプの場合は、値 IPM.StickyNote を使用します。
- 投稿 メッセージ タイプの場合は、値 IPM.Post を使用します。
- RSS アイテム メッセージ タイプの場合は、値 IPM.Post.RSS を使用します。
- タスク メッセージ タイプの場合は、値 IPM.Task* を使用します。
- ボイス メール メッセージ タイプの場合は、値 IPM.Note.Microsoft.Voicemail* を使用します。
カスタム メッセージ クラスの有効なパラメーターの値は、次のとおりです。
- 特定のメッセージ クラス (IPM.NOTE など)。
- アスタリスクのワイルドカード文字 (*)。この文字は、コンテンツ設定がすべてのメッセージ クラスに適用されることを示します。
- アスタリスク ワイルドカード文字を持つ特定のメッセージ クラス。 アスタリスク ワイルドカード文字は、メッセージ クラスの最後の文字として表示する必要があります。 たとえば、IPM です。注* (IPM を含む)。NOTE とすべてのサブクラス) または IPM。注.* (IPM のサブクラスが含まれます)。注 IPM ではありません。NOTE 自体)。 *.注と 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
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。