New-ManagedFolder
このコマンドレットは Exchange Server 2010 でのみ使用可能です。
New-ManagedFolder コマンドレットを使用して、メッセージング レコード管理 (MRM) 用の管理フォルダー オブジェクトを作成します。
このコマンドはパイプライン入力を受け入れません。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
ManagedDefaultFolder
New-ManagedFolder
[-Name] <String>
-DefaultFolderType <DefaultManagedFolderType>
[-BaseFolderOnly <Boolean>]
[-Comment <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-LocalizedComment <MultiValuedProperty>]
[-MustDisplayCommentEnabled <Boolean>]
[-WhatIf]
[<CommonParameters>]
ManagedCustomFolder
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 パラメーターを使用して、作成する既定のフォルダーの種類 (追加の受信トレイ フォルダーなど) を指定するために、既定の管理フォルダーの追加コピーを作成することもできます。 管理された既定のフォルダーの複数のコピーを作成する場合は、それぞれに異なるコンテンツ設定を割り当てることができます。 たとえば、受信トレイ フォルダーが 2 つあり、1 つは InboxSixMonths、もう 1 つは InboxOneYear という名前であるとします。 次に、New-ManagedContentSettings コマンドレットを使用して (またはExchange 管理コンソールの [新しい管理コンテンツの設定] ウィザードを使用して)、最初のフォルダーに 6 か月、2 番目のフォルダーに 1 年の保持期間を割り当てることができます。 作成する既定の管理フォルダーごとに、一意の名前を (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
この例では、既定のフォルダーである Inbox のインスタンスを作成します。
パラメーター
-BaseFolderOnly
適用対象: Exchange Server 2010
BaseFolderOnly パラメーターは、管理コンテンツ設定を管理フォルダーだけに適用するか、またはフォルダーとそのすべてのサブフォルダーに適用するかを指定します。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Comment
適用対象: Exchange Server 2010
Comment パラメーターは、Microsoft Office Outlook 2007 および Microsoft Office Outlook Web App のフォルダーと共に表示される既定の管理者コメントを指定します。 コメントの長さは、スペースを含めて最大 255 文字です。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Confirm
適用対象: Exchange Server 2010
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットに与える影響は、コマンドレットが続行する前に確認を必要とするかどうかによって異なります。
- データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$falseを使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値を指定せずに Confirm スイッチを指定すると、一時停止が発生し、続行する前にコマンドの確認を強制されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | Cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DefaultFolderType
適用対象: Exchange Server 2010
DefaultFolderType パラメーターは、作成する既定のフォルダーの種類 (受信トレイや削除済みアイテムなど) を指定します。
管理フォルダー メールボックス ポリシーには、既定のフォルダーの種類ごとに 1 つの管理フォルダーしか含めることができません。 受信トレイなど、特定の種類の既定のフォルダーを追加し、別のメールボックス ポリシーに追加できます。 これにより、一連のユーザーごとに、特定の既定のフォルダーの種類に対して異なる管理コンテンツ設定を割り当てることができます。
たとえば、受信トレイ タイプの既定のフォルダーが 2 つあり、1 つはメッセージを 1 か月間保持するように設定された管理コンテンツ設定、もう 1 つは 1 年間メッセージを保持するように設定されたフォルダーです。 既定の管理フォルダーにはそれぞれ、(Name パラメーターを使用して割り当てられる) 一意の名前を付ける必要があります。
DefaultFolderType パラメーターに値が入力されていない場合は、管理されたカスタム フォルダーとして扱われます。
指定できる既定のフォルダーの種類は次のとおりです。
- 予定表
- 連絡先
- DeletedItems
- 下書き
- 受信トレイ
- JunkEmail
- ジャーナル
- メモ
- 送信トレイ
- SentItems
- タスク
- すべて
- ManagedCustomFolder
- RssSubscriptions
- SyncIssues
- ConversationHistory
パラメーターのプロパティ
| 型: | DefaultManagedFolderType |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ManagedDefaultFolder
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DomainController
適用対象: Exchange Server 2010
DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。
パラメーターのプロパティ
| 型: | Fqdn |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-FolderName
適用対象: Exchange Server 2010
FolderName パラメーターは、ユーザーのメールボックスに表示されるフォルダー名を指定します。 フォルダー名は 255 文字以内で指定します。 受信トレイなどの既定の管理フォルダーには FolderName パラメーターを設定することはできません。
FolderName パラメーターを Name パラメーターと混同しないでください。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ManagedCustomFolder
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-LocalizedComment
適用対象: Exchange Server 2010
LocalizedComment パラメーターは、ローカライズされた管理者コメントとその言語を指定します。 Outlook 2007 の言語設定が、このパラメータで指定されたロケールのいずれかと一致すると、対応するローカライズされたコメントが表示されます。 コメントは、ISOLanguageCode:Comment という形式にする必要があります (たとえば、-LocalizedComment EN-US:"This is a localized comment in U.S. English")。
パラメーターのプロパティ
| 型: | MultiValuedProperty |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-LocalizedFolderName
適用対象: Exchange Server 2010
LocalizedFolderName パラメーターは、ローカライズされたフォルダー名とその言語を指定します。 Outlook 2007 の言語設定が、このパラメーターで指定されたロケールのいずれかと一致すると、対応するローカライズされたフォルダー名が表示されます。 フォルダー名は、ISOLanguageCode:FolderName の形式にする必要があります (例: -LocalizedFolderName EN-US:"Business Critical")。
パラメーターのプロパティ
| 型: | MultiValuedProperty |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ManagedCustomFolder
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MustDisplayCommentEnabled
適用対象: Exchange Server 2010
MustDisplayCommentEnabled パラメーターは、ユーザーがフォルダー コメント (Outlook 2007 および Outlook Web App に表示されます) をユーザーが最小化できないようにするために Outlook 2007 で使用されるフラグを設定するかどうかを指定します。 MustDisplayCommentEnabled パラメーターが存在し、$trueに設定されている場合、このパラメーターは、ユーザーがフォルダー コメントを最小化できないようにするために Outlook 2007 で使用されるフラグを設定します。 パラメーターが存在しない場合、または $false に設定されている場合、ユーザーはコメントを最小化できます。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
適用対象: Exchange Server 2010
Name パラメーターは、Active Directory 内の管理フォルダー オブジェクトの一意の名前を指定します。 名前は最大 65 文字まで設定できます。 FolderName パラメーターは、クライアントでユーザーに表示されるフォルダー名を指定するのに対し、Name パラメーターは、Exchange 管理ツールが管理フォルダー オブジェクトを表すために使用されます。
Name パラメーターを FolderName パラメーターと混同しないでください。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-StorageQuota
適用対象: Exchange Server 2010
StorageQuota パラメーターは、メールボックス フォルダーの記憶域サイズ制限を指定します。 フォルダー サイズがこの制限を超えると、追加アイテムは無効になります。 ストレージ サイズの制限は、100 KB や 5 MB などのキロバイト (KB) またはメガバイト (MB) で指定できます。
パラメーターのプロパティ
| 型: | Unlimited |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ManagedCustomFolder
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
適用対象: Exchange Server 2010
[WhatIf] スイッチは、何も変更を加えずにコマンドが実行する内容を表示します。 このスイッチで値を指定する必要はありません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | wi |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。