New-ManagedFolder

リファレンス

モジュール:: ExchangePowerShell

適用対象:: Exchange Server 2010

このコマンドレットは Exchange Server 2010 でのみ使用可能です。

New-ManagedFolder コマンドレットを使用して、メッセージングレコード管理 (MRM) 用のマネージドフォルダーオブジェクトを作成します。

このコマンドでは、パイプライン入力は受け入れられません。

以下の構文セクションのパラメーターセットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

New-ManagedFolder
   [-Name] <String>
   -DefaultFolderType <DefaultManagedFolderType>
   [-BaseFolderOnly <Boolean>]
   [-Comment <String>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-LocalizedComment <MultiValuedProperty>]
   [-MustDisplayCommentEnabled <Boolean>]
   [-WhatIf]
   [<CommonParameters>]

New-ManagedFolder
   [-Name] <String>
   -FolderName <String>
   [-LocalizedFolderName <MultiValuedProperty>]
   [-StorageQuota <Unlimited>]
   [-BaseFolderOnly <Boolean>]
   [-Comment <String>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-LocalizedComment <MultiValuedProperty>]
   [-MustDisplayCommentEnabled <Boolean>]
   [-WhatIf]
   [<CommonParameters>]

説明

New-ManagedFolder コマンドレットは、Active Directory に新しいマネージドフォルダーを作成します。新しいマネージドフォルダーオブジェクトを作成した後、MRM で使用するには、次の手順を実行する必要があります。

フォルダーのマネージドコンテンツ設定を作成します。詳細については、「マネージドコンテンツ設定の作成」を参照してください。
マネージドフォルダーを既存の管理フォルダーメールボックスポリシーにリンクするか、マネージドフォルダーメールボックスポリシーを作成して、その管理フォルダーをそのフォルダーにリンクします。
管理フォルダーメールボックスポリシーをユーザーのメールボックスに適用します。詳細については、「管理対象フォルダーメールボックスポリシーをユーザーに適用する」を参照してください。
マネージドフォルダーアシスタントがスケジュールされていることを確認するか、マネージドフォルダーアシスタントを手動で実行します。マネージドフォルダーアシスタントのスケジュール設定の詳細については、「マネージドフォルダーアシスタントの構成」を参照してください。マネージドフォルダーアシスタントを実行すると、既定のフォルダーが管理フォルダーとして構成され、設定が指定された状態でユーザーのメールボックスにマネージドカスタムフォルダーが作成されます。
Microsoft Exchange Server 2010 で MRM を実装する手順の詳細については、「メッセージングレコード管理の展開」を参照してください。

既定では、このコマンドレットを使用してマネージドカスタムフォルダーが作成されます。ただし、DefaultFolderType パラメーターを使用して、既定の管理フォルダーの追加コピーを作成して、作成する既定のフォルダーの種類 (追加の受信トレイフォルダーなど) を指定することもできます。管理された既定のフォルダーの複数のコピーを作成する場合は、それぞれに異なるコンテンツ設定を割り当てることができます。たとえば、InboxSixMonths という名前の 2 つの受信トレイフォルダーと InboxOneYear という名前の 2 つの受信トレイフォルダーを作成できます。次に、1 つ目のフォルダーに 6 か月の保持時間を割り当て、2 つ目のフォルダーに 1 年間を割り当て、New-ManagedContentSettings コマンドレットを使用します (または、Exchange 管理コンソールの [新しい管理コンテンツ設定] ウィザードを使用します)。 (Name パラメーターを使用して) 一意の名前を、作成する管理された既定の各フォルダーに割り当てる必要があります。ただし、ユーザーには、変更されていない既定のフォルダー名が常に表示されます。この例では、ユーザーに InboxSixMonths フォルダーまたは InboxOneYear フォルダーが割り当てられているかどうかに関係なく、メールボックスに表示される受信トレイに [受信トレイ] というラベルが付けられます。ユーザーがメールボックスに表示するフォルダー名は、(Set-ManagedFolder コマンド FolderName パラメーターを使用して) マネージドカスタムフォルダーに再割り当てできますが、管理対象の既定のフォルダーのユーザーに表示されるフォルダー名は変更できません。

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。

例

例 1

New-ManagedFolder -Name NewFolder -FolderName "New Folder" -StorageQuota "1 MB"

この例では、最大容量が 1 MB のマネージドフォルダーを作成します。

例 2

New-ManagedFolder -Name MyFolder -FolderName "My Folder" -LocalizedFolderName Spanish:"Mi Carpeta", French:"Mon Dossier" -Comment "My comment" -LocalizedComment Spanish:"Mi comentario", French:"Mon annotation"

次の使用例は、既定のフォルダー名と英語でのコメント、スペイン語とフランス語のローカライズされたフォルダー名、スペイン語とフランス語のローカライズされたコメントを含む管理フォルダーを作成します。

例 3

New-ManagedFolder -Name AnotherInbox -DefaultFolderType Inbox

次の使用例は、既定のフォルダー受信トレイのインスタンスを作成します。

パラメーター

-BaseFolderOnly

BaseFolderOnly パラメーターは、管理コンテンツ設定を管理フォルダーだけに適用するか、またはフォルダーとそのすべてのサブフォルダーに適用するかを指定します。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Comment

Comment パラメーターは、Office Outlook 2007 と Office Outlook Web Appのフォルダー Microsoft表示する既定の管理者コメントMicrosoft指定します。コメントの文字数は、スペースを含めて最大 255 文字です。

Type:	String
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

-DefaultFolderType

DefaultFolderType パラメーターは、受信トレイや削除済みアイテムなど、作成する既定のフォルダーの種類を指定します。

管理フォルダーメールボックスポリシーは、既定のフォルダーの種類ごとに 1 つの管理フォルダーのみを持つことができます。受信トレイなど、特定の種類の追加の既定のフォルダーを作成し、さまざまなメールボックスポリシーに追加できます。これにより、ユーザーのセットごとに、特定の既定のフォルダーの種類に対して異なる管理コンテンツ設定を割り当てることができます。

たとえば、受信トレイ型の既定のフォルダーが 2 つあり、1 つには管理コンテンツ設定が 1 か月間メッセージを保持するように設定され、もう 1 つはメッセージを 1 年間保持する設定が設定されています。管理対象の既定の各フォルダーには、一意の名前が必要です (Name パラメーターを使用して割り当てられます)。

DefaultFolderType パラメーターに値が入力されていない場合は、マネージドカスタムフォルダーとして扱われます。

指定できる既定のフォルダーの種類は次のとおりです。

予定表
連絡先
DeletedItems
下書き
受信トレイ
JunkEmail
ジャーナル
メモ
送信トレイ
SentItems
タスク
すべて
ManagedCustomFolder
RssSubscriptions
SyncIssues
ConversationHistory

Type:	DefaultManagedFolderType
Position:	Named
Default value:	None
Required:	True
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 パラメーターは、ユーザーのメールボックスに表示されるフォルダー名を指定します。フォルダー名の文字数は最大 255 文字です。管理された既定のフォルダー (受信トレイなど) に FolderName パラメーターを設定することはできません。

FolderName パラメーターを Name パラメーターと混同しないでください。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-LocalizedComment

LocalizedComment パラメーターは、ローカライズされた管理者のコメントとその言語を指定します。 Outlook 2007 の言語設定がこのパラメーターで指定されているロケールのいずれかに一致すると、対応するローカライズされたコメントが表示されます。コメントは ISOLanguageCode:Comment 形式である必要があります (例: -LocalizedComment EN-US:"これは、米国英語のローカライズされたコメントです")。

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-LocalizedFolderName

LocalizedFolderName パラメーターは、ローカライズされたフォルダー名とその言語を指定します。 Outlook 2007 の言語設定がこのパラメーターで指定されているロケールのいずれかに一致すると、対応するローカライズされたフォルダー名が表示されます。フォルダー名は ISOLanguageCode:FolderName という形式である必要があります (例: -LocalizedFolderName EN-US:"Business Critical")。

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-MustDisplayCommentEnabled

MustDisplayCommentEnabled パラメーターは、Outlook 2007 で使用されるフラグを設定して、ユーザーがフォルダーコメント (Outlook 2007 および Outlook Web App で表示される) を最小限に抑えないようにするかどうかを指定します。 MustDisplayCommentEnabled パラメーターが存在し、$trueに設定されている場合、パラメーターは Outlook 2007 で使用されるフラグを設定して、ユーザーがフォルダーコメントを最小限に抑えないようにします。パラメーターが存在しない場合、または $false に設定されている場合、ユーザーはコメントを最小限に抑えることができます。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Name

Name パラメーターは、Active Directory のマネージドフォルダーオブジェクトの一意の名前を指定します。名前の文字数は最大 65 文字です。 FolderName パラメーターは、クライアント内のユーザーに表示されるフォルダー名を指定しますが、Name パラメーターは Exchange 管理ツールによってマネージドフォルダーオブジェクトを表すために使用されます。

Name パラメーターを FolderName パラメーターと混同しないでください。

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-StorageQuota

StorageQuota パラメーターは、メールボックスフォルダーのストレージサイズ制限を指定します。フォルダーのサイズがこの制限を超えた場合、追加の項目を追加することはできません。ストレージサイズの制限は、キロバイト (KB) または MB (100 KB や 5 MB など) で指定できます。

Type:	Unlimited
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

このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。