Set-MailboxDatabase
適用先: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
トピックの最終更新日: 2007-09-19
メールボックス データベースの属性を設定するには、Set-MailboxDatabase コマンドレットを使用します。
構文
Set-MailboxDatabase -Identity <DatabaseIdParameter> [-AllowFileRestore <$true | $false>] [-Confirm [<SwitchParameter>]] [-DeletedItemRetention <EnhancedTimeSpan>] [-DomainController <Fqdn>] [-EventHistoryRetentionPeriod <EnhancedTimeSpan>] [-IndexEnabled <$true | $false>] [-IssueWarningQuota <Unlimited>] [-JournalRecipient <RecipientIdParameter>] [-MailboxRetention <EnhancedTimeSpan>] [-MaintenanceSchedule <Schedule>] [-MountAtStartup <$true | $false>] [-Name <String>] [-OfflineAddressBook <OfflineAddressBookIdParameter>] [-ProhibitSendQuota <Unlimited>] [-ProhibitSendReceiveQuota <Unlimited>] [-PublicFolderDatabase <DatabaseIdParameter>] [-QuotaNotificationSchedule <Schedule>] [-RetainDeletedItemsUntilBackup <$true | $false>] [-WhatIf [<SwitchParameter>]]
Set-MailboxDatabase [-AllowFileRestore <$true | $false>] [-Confirm [<SwitchParameter>]] [-DeletedItemRetention <EnhancedTimeSpan>] [-DomainController <Fqdn>] [-EventHistoryRetentionPeriod <EnhancedTimeSpan>] [-IndexEnabled <$true | $false>] [-Instance <MailboxDatabase>] [-IssueWarningQuota <Unlimited>] [-JournalRecipient <RecipientIdParameter>] [-MailboxRetention <EnhancedTimeSpan>] [-MaintenanceSchedule <Schedule>] [-MountAtStartup <$true | $false>] [-Name <String>] [-OfflineAddressBook <OfflineAddressBookIdParameter>] [-ProhibitSendQuota <Unlimited>] [-ProhibitSendReceiveQuota <Unlimited>] [-PublicFolderDatabase <DatabaseIdParameter>] [-QuotaNotificationSchedule <Schedule>] [-RetainDeletedItemsUntilBackup <$true | $false>] [-WhatIf [<SwitchParameter>]]
解説
Set-MailboxDatabase コマンドレットを実行するには、使用するアカウントに次の役割が委任されている必要があります。
- Exchange サーバー管理者の役割および対象サーバーのローカル Administrators グループ
Microsoft Exchange Server 2007 を管理するために必要なアクセス許可、役割の委任、および権限の詳細については、「アクセス許可に関する考慮事項」を参照してください。
パラメータ
パラメータ | 必須かどうか | 種類 | 説明 |
---|---|---|---|
Identity |
必須 |
Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter |
Identity パラメータは、属性を設定するメールボックス データベースを示します。次の値を使用できます。
サーバー名を指定しない場合、コマンドレットはローカル サーバー上でデータベースを検索します。同じ名前で複数のデータベースがある場合は、ストレージ グループを指定する必要があります。 |
AllowFileRestore |
省略可能 |
System.Boolean |
AllowFileRestore パラメータは、バックアップからのデータベースの復元を許可するかどうかを指定します。指定できる値は $true または $false の 2 つです。$true を指定すると、コマンドは、Active Directory ディレクトリ サービスのデータベース エントリと一致しないデータベースのマウントを許可します。$false を指定すると、コマンドは Active Directory のデータベース エントリと一致しないデータベースのマウントを許可しないので、既存のデータベースを新しく作成したデータベースに置き換えることはできません。 |
Confirm |
省略可能 |
System.Management.Automation.SwitchParameter |
Confirm パラメータを指定すると、コマンドの処理が一時停止します。処理を続行するには、コマンドの処理内容を確認する必要があります。Confirm パラメータで値を指定する必要はありません。 |
DeletedItemRetention |
省略可能 |
Microsoft.Exchange.Data.EnhancedTimeSpan |
DeletedItemRetention パラメータは、削除済みアイテムを保持する期間を指定します。値を指定するには、dd.hh:mm:ss の形式で期間として入力します。d = 日、h = 時間、m = 分、および s = 秒です。たとえば、15 時間間隔を指定するには、「15:00:00」と入力します。削除したアイテムを保持する時間の最大値は 24,855 日です。既定では、削除済みアイテムは 14 日間保存されます。この属性は、このメールボックス データベース内で、独自のアイテム保持属性が設定されていないすべてのメールボックスに適用されます。 |
DomainController |
省略可能 |
Microsoft.Exchange.Data.Fqdn |
この構成の変更を Active Directory に書き込むドメイン コントローラの完全修飾ドメイン名 (FQDN) を指定するには、コマンドに DomainController パラメータを含めます。 |
EventHistoryRetentionPeriod |
省略可能 |
Microsoft.Exchange.Data.EnhancedTimeSpan |
EventHistoryRetentionPeriod パラメータは、イベント データを保持する期間を指定します。このイベント データは、Exchange ストア内のイベント履歴テーブルに格納されます。これには、メールボックス データベース内の各種のオブジェクトへの変更に関する情報が含まれます。このパラメータを使用すると、イベント履歴テーブルが大きくなりすぎて過剰なディスク領域が使用されることを防止できます。値を指定するには、dd.hh:mm:ss の形式で期間として入力します。d = 日、h = 時間、m = 分、s = 秒です。たとえば、15 時間間隔を指定するには、「15:00:00」と入力します。 |
IndexEnabled |
省略可能 |
System.Boolean |
IndexEnabled パラメータは、このメールボックス データベースに対して Exchange Search を有効にするかどうかを指定します。このパラメータに指定できる値は $true または $false の 2 つです。 |
Instance |
省略可能 |
Microsoft.Exchange.Data.Directory.SystemConfiguration.MailboxDatabase |
Instance パラメータは、通常、管理者または開発者がコマンドに値を渡す必要がある場合に、スクリプトの中で使用します。Instance パラメータはコマンドの結果を別のコマンドにパイプ処理することと同じですが、スクリプトは、パイプラインの作成を試みるのではなく、変数を介して値を割り当てることができます。コマンド プロンプトでコマンドを入力する管理者が Instance パラメータを使用することはあまりありません。これは開発者の参照用としてパラメータ テーブルに含まれます。 |
IssueWarningQuota |
省略可能 |
Microsoft.Exchange.Data.Unlimited |
IssueWarningQuota パラメータは、ユーザーに警告メッセージを送信するときのメールボックスのサイズを指定します。 この属性は、このメールボックス データベース内で、独自の警告クォータ属性が設定されていないすべてのメールボックスに適用されます。整数または "unlimited" を指定する必要があります。既定値は 1.9 GB (ギガバイト) です。 |
JournalRecipient |
省略可能 |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter |
JournalRecipient パラメータには、ジャーナル レポートの送信先であるメールボックスを指定します。 |
MailboxRetention |
省略可能 |
Microsoft.Exchange.Data.EnhancedTimeSpan |
MailboxRetention パラメータは、削除済みメールボックスを保持する期間を指定します。値を指定するには、dd.hh:mm:ss の形式で期間として入力します。d = 日、h = 時間、m = 分、および s = 秒です。たとえば、15 時間間隔を指定するには、「15:00:00」と入力します。メールボックスを保持する時間の最大値は 24,855 日です。既定では、削除済みメールボックスは 30 日間保存されます。この属性は、このメールボックス データベース内のすべてのメールボックスに適用されます。 |
MaintenanceSchedule |
省略可能 |
Microsoft.Exchange.Data.Schedule |
MaintenanceSchedule パラメータでは、メールボックス データベースに対して保守を実行する時間を指定します。保守には、オンラインでのディスクの最適化、保存期間を過ぎたアイテムの削除、未使用のインデックスの削除、およびその他のクリーンアップ作業が含まれます。 形式は、開始曜日.時:分 [AM/PM]-終了曜日.時:分 [AM/PM] です。開始曜日と終了曜日には次の値を使用できます。
24 時間形式を使用する場合、AM/PM は省略します。AM/PM を使用する場合は、時刻と AM または PM の間にスペースを入れる必要があります。 形式は混在してもかまいません。 開始時刻と終了時刻は 15 分以上離れている必要があります。分は 0、15、30、または 45 に切り捨てられます。複数の時間帯を指定する場合は、各時間帯を 15 分以上離す必要があります。 例 :
|
MountAtStartup |
省略可能 |
System.Boolean |
MountAtStartup パラメータでは、Microsoft Exchange Information Store サービスの開始時にこのメールボックス データベースをマウントするかどうかを指定します。このパラメータに指定できる値は $true または $false の 2 つです。 |
Name |
省略可能 |
System.String |
Name パラメータでは、メールボックス データベースの名前を指定します。 |
OfflineAddressBook |
省略可能 |
Microsoft.Exchange.Configuration.Tasks.OfflineAddressBookIdParameter |
OfflineAddressBook パラメータでは、このメールボックス データベースに関連付けられたアドレス帳を指定します。 |
ProhibitSendQuota |
省略可能 |
Microsoft.Exchange.Data.Unlimited |
ProhibitSendQuota パラメータでは、このメールボックス データベースのメールボックスに関連付けられているユーザーがメッセージを送信できなくなるメールボックスのサイズを指定します。この属性は、このメールボックス データベース内で、独自の送信禁止クォータ属性が設定されていないすべてのメールボックスに適用されます。 整数または "unlimited" を指定する必要があります。 |
ProhibitSendReceiveQuota |
省略可能 |
Microsoft.Exchange.Data.Unlimited |
ProhibitSendReceiveQuota パラメータでは、このメールボックスに関連付けられているユーザーがメッセージを送信または受信できなくなるメールボックスのサイズを指定します。この属性は、このメールボックス データベース内で、独自の送受信禁止クォータ属性が設定されていないすべてのメールボックスに適用されます。 整数または "unlimited" を指定する必要があります。 |
PublicFolderDatabase |
省略可能 |
Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter |
PublicFolderDatabase パラメータでは、このメールボックス データベースに関連付けられたパブリック フォルダ データベースを指定します。次の値を使用できます。
|
QuotaNotificationSchedule |
省略可能 |
Microsoft.Exchange.Data.Schedule |
QuotaNotificationSchedule パラメータでは、いずれかのクォータ値に達したメールボックスに、いつクォータ メッセージを送信するかを指定します。 形式は、開始曜日.時:分 [AM/PM]-終了曜日.時:分 [AM/PM] です。開始曜日と終了曜日には次の値を使用できます。
24 時間形式を使用する場合、AM/PM は省略します。 形式は混在してもかまいません。 開始時刻と終了時刻は 15 分以上離れている必要があります。分は 0、15、30、または 45 に切り捨てられます。複数の時間帯を指定する場合は、各時間帯を 15 分以上離す必要があります。 例 :
|
RetainDeletedItemsUntilBackup |
省略可能 |
System.Boolean |
RetainDeletedItemsUntilBackup パラメータでは、次回バックアップを実行するまで削除アイテムを保持するかどうかを指定します。このパラメータに指定できる値は $true または $false の 2 つです。 |
WhatIf |
省略可能 |
System.Management.Automation.SwitchParameter |
WhatIf パラメータには、オブジェクトに対して行われる操作をシミュレートすることを指定します。WhatIf パラメータを使用することで、実際に変更を加えずに、発生する変更内容を表示することができます。WhatIf パラメータで値を指定する必要はありません。 |
入力の種類
戻り値の種類
エラー
エラー | 説明 |
---|---|
|
例外
例外 | 説明 |
---|---|
|
例
次の例では、削除されたアイテムを保持する時間の長さを設定する方法を示します。特定のメールボックスに独自のアイテム保持属性が設定されている場合は、メールボックス データベースに対して設定されているこの値の代わりに、その値が使用されます。
Set-MailboxDatabase "Mailbox Database01" -DeletedItemRetention 7.00:00:00
参照している情報が最新であることを確認したり、他の Exchange Server 2007 ドキュメントを見つけたりするには、Exchange Server TechCenter を参照してください。