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 パラメータは、属性を設定するメールボックス データベースを示します。次の値を使用できます。

  • GUID
  • 識別名 (DN)
  • メールボックス データベースの名前
  • <サーバー名>\<ストレージ グループ名>\<データベース名>
  • <サーバー名>\<データベース名>
  • <ストレージ グループ名>\<データベース名>

サーバー名を指定しない場合、コマンドレットはローカル サーバー上でデータベースを検索します。同じ名前で複数のデータベースがある場合は、ストレージ グループを指定する必要があります。

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] です。開始曜日と終了曜日には次の値を使用できます。

  • 曜日のフルネーム
  • 曜日の略称
  • 0 ～ 6 の整数、0 = 日曜

24 時間形式を使用する場合、AM/PM は省略します。AM/PM を使用する場合は、時刻と AM または PM の間にスペースを入れる必要があります。

形式は混在してもかまいません。

開始時刻と終了時刻は 15 分以上離れている必要があります。分は 0、15、30、または 45 に切り捨てられます。複数の時間帯を指定する場合は、各時間帯を 15 分以上離す必要があります。

例 :

  • "Sun.11:30 PM-Mon.1:30 AM"
  • 6.22:00-6.22:15 (保守を土曜午後 10:00 から土曜午後 10:15 まで実行)
  • "Monday.4:30 AM-Monday.5:30 AM","Wednesday.4:30 AM-Wednesday.5:30 AM" (保守を月曜と水曜の朝の 4:30 から 5:30 まで実行)
  • "Sun.1:15 AM-Monday.23:00"

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 パラメータでは、このメールボックス データベースに関連付けられたパブリック フォルダ データベースを指定します。次の値を使用できます。

  • GUID
  • 識別名 (DN)
  • パブリック フォルダ データベースの名前
  • <サーバー名>\<ストレージ グループ名>\<データベース名>
  • <サーバー名>\<データベース名>
  • <ストレージ グループ名>\<データベース名>

QuotaNotificationSchedule

省略可能

Microsoft.Exchange.Data.Schedule

QuotaNotificationSchedule パラメータでは、いずれかのクォータ値に達したメールボックスに、いつクォータ メッセージを送信するかを指定します。

形式は、開始曜日.時:分 [AM/PM]-終了曜日.時:分 [AM/PM] です。開始曜日と終了曜日には次の値を使用できます。

  • 曜日のフルネーム
  • 曜日の略称
  • 0 ～ 6 の整数、0 = 日曜

24 時間形式を使用する場合、AM/PM は省略します。

形式は混在してもかまいません。

開始時刻と終了時刻は 15 分以上離れている必要があります。分は 0、15、30、または 45 に切り捨てられます。複数の時間帯を指定する場合は、各時間帯を 15 分以上離す必要があります。

例 :

  • "Sun.11:30 PM-Mon.1:30 AM"
  • 6.22:00-6.22:15 (通知を土曜午後 10:00 から土曜午後 10:15 まで実行)
  • "Monday.4:30 AM-Monday.5:30 AM","Wednesday.4:30 AM-Wednesday.5:30 AM" (通知を月曜と水曜の朝の 4:30 から 5:30 まで実行)
  • "Sun.1:15 AM-Monday.23:00"

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 を参照してください。