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