New-MailboxSearch

構文

Default (既定)

New-MailboxSearch
    [-Name] <String>
    [-AllPublicFolderSources <Boolean>]
    [-AllSourceMailboxes <Boolean>]
    [-Confirm]
    [-Description <String>]
    [-DomainController <Fqdn>]
    [-DoNotIncludeArchive]
    [-EndDate <ExDateTime>]
    [-EstimateOnly]
    [-ExcludeDuplicateMessages <Boolean>]
    [-Force]
    [-IncludeKeywordStatistics]
    [-IncludeUnsearchableItems]
    [-InPlaceHoldEnabled <Boolean>]
    [-InPlaceHoldIdentity <String>]
    [-ItemHoldPeriod <Unlimited>]
    [-Language <CultureInfo>]
    [-LogLevel <LoggingLevel>]
    [-MessageTypes <KindKeyword[]>]
    [-Recipients <String[]>]
    [-SearchDumpster]
    [-SearchQuery <String>]
    [-Senders <String[]>]
    [-SourceMailboxes <RecipientIdParameter[]>]
    [-StartDate <ExDateTime>]
    [-StatusMailRecipients <RecipientIdParameter[]>]
    [-TargetMailbox <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

説明

例

例 1

New-MailboxSearch -Name "Legal-ProjectX" -SourceMailboxes DG-Marketing,DG-Executives -TargetMailbox LegalDiscovery@contoso.com -StartDate "01/01/2018" -EndDate "12/31/2018" -Recipients "@contoso.com" -SearchQuery "project report hasattachments:true" -StatusMailRecipients "DG-DiscoveryTeam"

例 2

New-MailboxSearch -Name "Hold-ProjectX" -SourceMailboxes DG-Finance -InPlaceHoldEnabled $true

例 3

New-MailboxSearch -Name "Hold-tailspintoys" -SourceMailboxes DG-Research -SearchQuery '"Patent" AND "Project tailspintoys"' -InPlaceHoldEnabled $true

例 4

New-MailboxSearch -Name "Hold for all PFs" -AllPublicFolderSources $true -InPlaceHoldEnabled $true

パラメーター

-AllPublicFolderSources

適用対象: Exchange Server 2016 年、Exchange Server 2019、Exchange Online

AllPublicFolderSources パラメーターは組織内のすべてのパブリック フォルダーを検索に含めるかどうかを指定します。 有効な値は次のとおりです。

• $true: すべてのパブリック フォルダーが検索に含まれます。 この値は、AllSourceMailboxes パラメーターの値が$falseされ、SourceMailboxes パラメーターを使用して 1 つ以上のソース メールボックスを指定しない場合に必要です (パラメーター値は空白 [$null])。
• $false: 検索にパブリック フォルダーは含まれません。 この値が既定値です。 この値は、AllSourceMailboxes パラメーターの値が$trueされている場合、または SourceMailboxes パラメーターを使用して 1 つ以上のソース メールボックスを指定する場合に使用できます (パラメーター値は空白 [$null] ではありません)。

パラメーターのプロパティ

パラメーター セット

-AllSourceMailboxes

適用対象: Exchange Server 2016 年、Exchange Server 2019、Exchange Online

AllSourceMailboxes パラメーターは、検索にすべてのメールボックスを含めるかどうかを指定します。 有効な値は次のとおりです。

• $true: すべてのメールボックスが検索に含まれます。 この値は、AllPublicFolderSources パラメーターの値が$falseされ、SourceMailboxes パラメーターを使用して 1 つ以上のソース メールボックスを指定しない場合に必要です (パラメーター値は空白 [$null])。
• $false: すべてのメールボックスが検索に含まれていません。 この値が既定値です。 この値は、AllPublicFolderSources パラメーターの値が$trueされている場合、または SourceMailboxes パラメーターを使用して 1 つ以上のソース メールボックスを指定する場合に使用できます (パラメーター値は空白 [$null] ではありません)。

パラメーターのプロパティ

パラメーター セット

-Confirm

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection

Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。

• データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文-Confirm:$falseを使用して、確認プロンプトを省略できます。
• 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。

パラメーターのプロパティ

パラメーター セット

-Description

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

Description パラメーターは、検索の説明を指定します。 説明はユーザーに対しては表示されません。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。

パラメーターのプロパティ

パラメーター セット

-DomainController

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。

パラメーターのプロパティ

パラメーター セット

-DoNotIncludeArchive

適用対象: Exchange Server 2010

このパラメーターは Exchange Server 2010 でのみ使用できます。

DoNotIncludeArchive スイッチは、アーカイブ メールボックスが検索に含まれないことを指定します。 このスイッチで値を指定する必要はありません。

既定では、アーカイブ メールボックスは検索に含まれます。 アーカイブ メールボックスを除外するには、このスイッチを使用します。

パラメーターのプロパティ

パラメーター セット

-EndDate

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

EndDate パラメーターには、日付範囲の終了日を指定します。

コマンドを実行するコンピューターの [地域のオプション] 設定で定義されている短い日付形式を使用します。 たとえば、コンピューターが短い日付形式 MM/dd/yyyy を使用するように構成されている場合は、「2018 年 9 月 1 日」と入力して、2018 年 9 月 1 日を指定します。 日付のみを入力したり、日付と時刻を入力することもできます。 日付と時刻を入力する場合は、値を引用符 (”) で囲む必要があります (例: "09/01/2018 5:00 PM")。

パラメーターのプロパティ

パラメーター セット

-EstimateOnly

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

EstimateOnly スイッチは、返される項目の数の見積もりのみが提供されるように指定します。 このスイッチで値を指定する必要はありません。

このスイッチを使用しない場合は、メッセージは対象のメールボックスにコピーされます。

パラメーターのプロパティ

パラメーター セット

-ExcludeDuplicateMessages

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

ExcludeDuplicateMessages パラメーターは、検索結果内のメッセージの重複を排除します。 有効な値は次のとおりです。

• $true: 同じメッセージが複数のフォルダーまたはメールボックスに存在する場合は、メッセージの 1 つのインスタンスをコピーします。 この値が既定値です。
• $false: 同じメッセージが複数のフォルダーまたはメールボックスに存在する場合は、メッセージのすべてのインスタンスをコピーします。

パラメーターのプロパティ

パラメーター セット

-Force

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

[強制] スイッチは、警告メッセージまたは確認メッセージを非表示にします。 このスイッチで値を指定する必要はありません。

管理者の入力を求めることが不適切な場合に、このスイッチを使用してタスクをプログラムによって実行することができます。

パラメーターのプロパティ

パラメーター セット

-IncludeKeywordStatistics

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

IncludeKeywordStatistics スイッチでは、検索結果でキーワード統計 (キーワードごとのインスタンス数) が返されます。 このスイッチで値を指定する必要はありません。

パラメーターのプロパティ

パラメーター セット

-IncludeUnsearchableItems

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

IncludeUnsearchableItems スイッチは、Exchange Search でインデックスを作成できなかったアイテムを結果に含める必要があることを指定します。 このスイッチで値を指定する必要はありません。

検索不能アイテムはクエリベースのインプレース保持用に保持されません。 検索不能アイテムを保持する必要がある場合は、不確定保持 (検索パラメーターを指定しない保持で、訴訟ホールドに似た機能を提供するもの) を作成する必要があります。

パラメーターのプロパティ

パラメーター セット

-InPlaceHoldEnabled

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection

InPlaceHoldEnabled パラメーターは、検索結果のアイテムをインプレース保持にするどうかを指定します。 有効な値は次のとおりです。

• $true: 検索結果 In-Place 保留が有効になっています。
• $false: 検索結果 In-Place 保留が有効になっていません。 この値が既定値です。

AllSourceMailboxes パラメーターが $true のときは、検索結果をインプレース保持にすることはできません。

保留を試みたが、SourceMailboxes パラメーターを使用してメールボックスを指定しない場合、コマンドは成功する可能性がありますが、メールボックスは保留 In-Place に配置されません。

パラメーターのプロパティ

パラメーター セット

-InPlaceHoldIdentity

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

このパラメーターは、Microsoft の内部使用のために予約されています。

パラメーターのプロパティ

パラメーター セット

-ItemHoldPeriod

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection

ItemHoldPeriod パラメーターは、メールボックスのアイテム (すべてのメールボックス アイテム、または検索クエリ結果で返されたアイテム) を何日間インプレース保持にするかを指定します。 期間は、メールボックスでアイテムを受信したとき、またはアイテムが作成されたときから計算します。 有効な値は次のとおりです。

• SyncSchedule パラメーターは、??? を指定します。このパラメーターの有効な値は次のとおりです。
• 値は unlimited です。 この値が既定値です。 アイテムは、In-Place Remove-MailboxSearch コマンドレットを使用して検索を削除し、Set-MailboxSearch コマンドレットと SourceMailboxes パラメーターを使用して検索からソース メールボックスを削除するか、オンプレミスの Exchange で、Set-MailboxSearch コマンドレットを使用してすべてのパブリック フォルダーを削除して、AllPublicFolderSources パラメーターを$trueから$falseに変更するまで保持されます。

パラメーターのプロパティ

パラメーター セット

-Language

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

Language パラメーターには、検索のロケールを指定します。

このパラメーターの正しい入力は、Microsoft .NET Framework CultureInfo クラスでサポートされているカルチャ コード値です。 たとえば、デンマーク語の場合には da-DK、日本語の場合には ja-JP となります。 詳細については、「CultureInfo クラス」を参照してください。

パラメーターのプロパティ

パラメーター セット

-LogLevel

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

LogLevel パラメーターは、検索のログ レベルを指定します。 有効な値は次のとおりです。

• 抑制: ログは保持されません。
• 基本: クエリに関する基本情報と、クエリを実行したユーザーは保持されます。 この値が既定値です。
• Full: Basic ログ レベルで保持される情報に加えて、完全なログ レベルによって検索結果の完全な一覧が追加されます。

パラメーターのプロパティ

パラメーター セット

-MessageTypes

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

MessageTypesパラメーターには、検索クエリに含めるメッセージの種類を指定します。 有効な値は次のとおりです。

• 連絡先
• ドキュメント
• 電子メール
• IM
• 仕訳 帳
• 会議
• メモ
• タスク

複数の値をコンマで区切って指定できます。

既定値は空白 ($null) です。これは、すべてのメッセージの種類が含まれるという意味です。

パラメーターのプロパティ

パラメーター セット

-Name

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

Name パラメーターは、検索のためのフレンドリ名を指定します。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。

このパラメーターの値を使って、TargetMailbox パラメーターで指定されている対象のメールボックスに検索結果を保持するトップ レベル フォルダーを作成します。

パラメーターのプロパティ

パラメーター セット

-Recipients

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

Recipients パラメーターは、検索クエリに含める 1 人または複数の受信者を指定します。 [宛先]、[CC]、[BCC] フィールド内に指定の受信者があるメッセージが検索結果に返されます。

複数の受信者をコンマで区切って指定できます。

パラメーターのプロパティ

パラメーター セット

-SearchDumpster

適用対象: Exchange Server 2010

このパラメーターは Exchange Server 2010 でのみ使用できます。

SearchDumpster スイッチは、ダンプスターを検索するかどうかを指定します。 このスイッチで値を指定する必要はありません。

ごみ箱は、削除済みアイテムフォルダーから削除または削除された後、またはハード削除された後、削除済みアイテムの保持設定に基づいてメールボックスから削除される前に、削除されたアイテムが一時的に格納されるメールボックス内のストレージ領域です。

パラメーターのプロパティ

パラメーター セット

-SearchQuery

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

SearchQuery パラメーターには、キーワード クエリ言語 (KQL) によって検索クエリのキーワードを指定します。 詳細については、「 キーワード クエリ言語 (KQL) 構文リファレンス」 および「 電子情報開示のキーワード クエリと検索条件」を参照してください。

このパラメーターを他の検索クエリ パラメーターと一緒に使う場合、クエリは AND 演算子でこれらのパラメーターを結合します。

その他の検索クエリのパラメーターは次のとおりです。

• EndDate
• MessageTypes
• 受信者
• 送信者
• StartDate

パラメーターのプロパティ

パラメーター セット

-Senders

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

Senders パラメーターは、検索クエリに含める 1 人または複数の送信者を指定します。 指定した送信者のメッセージは、検索結果に返されます。 送信者としては、たとえば、ユーザー、配布グループ (グループのメンバーにより送信されたメッセージ)、SMTP アドレス、ドメインなどを指定できます。

複数の送信者をコンマで区切って指定できます。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。

パラメーターのプロパティ

パラメーター セット

-SourceMailboxes

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

SourceMailboxes パラメーターは、検索する 1 つまたは複数のメールボックスの ID を指定します。 メールボックスを一意に識別する任意の値を使用できます。 次に例を示します。

• 名前
• Alias
• 識別名 (DN)
• 正規 DN
• 電子メール アドレス
• GUID

Update 値にスペースを含める、または引用符を必要とする場合は、次の構文を使用します: "Value1","Value2",..."ValueN"。

このパラメーターを使用するには、AllSourceMailboxes パラメーターを$falseする必要があります (既定値)。

既定値は空白 ($null) であり、ソース メールボックスが指定されていないことを意味します。 ソース メールボックスをクリアするには、$null値を使用します。

検索結果を保留 In-Place 有効にするには、AllSourceMailboxes パラメーターを $false (既定値) に設定し、次の設定のいずれかまたは両方を構成する必要があります。

• SourceMailboxes パラメーターを使って、1 つまたは複数のメールボックスを指定する。
• オンプレミス Exchange で、AllPublicFolderSources パラメーターを $true に設定します。

パラメーターのプロパティ

パラメーター セット

-StartDate

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

StartDate パラメーターは、日付範囲の開始日を指定します。

コマンドを実行するコンピューターの [地域のオプション] 設定で定義されている短い日付形式を使用します。 たとえば、コンピューターが短い日付形式 MM/dd/yyyy を使用するように構成されている場合は、「2018 年 9 月 1 日」と入力して、2018 年 9 月 1 日を指定します。 日付のみを入力したり、日付と時刻を入力することもできます。 日付と時刻を入力する場合は、値を引用符 (”) で囲む必要があります (例: "09/01/2018 5:00 PM")。

パラメーターのプロパティ

パラメーター セット

-StatusMailRecipients

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

StatusMailRecipients パラメーターは、検索の完了時に電子メールで状態メッセージを受信する 1 人または複数の受信者を指定します。 受信者を一意に識別する任意の値を使用できます。 たとえば、次の値を使用できます。

• 名前
• Alias
• 識別名 (DN)
• 正規 DN
• 電子メール アドレス
• GUID

Update 値にスペースを含める、または引用符を必要とする場合は、次の構文を使用します: "Value1","Value2",..."ValueN"。

パラメーターのプロパティ

パラメーター セット

-TargetMailbox

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

TargetMailbox パラメーターは、検索結果がコピーされる送信先メールボックスを指定します。 メールボックスを一意に識別する任意の値を使用できます。 例:

• 名前
• Alias
• 識別名 (DN)
• 正規 DN
• ドメイン\ユーザー名
• 電子メール アドレス
• GUID
• LegacyExchangeDN
• SamAccountName
• ユーザー ID またはユーザー プリンシパル名 (UPN)

パラメーターのプロパティ

パラメーター セット

-WhatIf

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection

WhatIf スイッチは、このコマンドレットでは機能しません。

パラメーターのプロパティ

パラメーター セット

CommonParameters

入力

Input types

出力

Output types