New-ManagedContentSettings

リファレンス

モジュール:: ExchangePowerShell

適用対象:: Exchange Server 2010

このコマンドレットは 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されます。