Get-FailedContentIndexDocuments
このコマンドレットは、Exchange Server 2016 以前でのみ機能します。
Get-FailedContentIndexDocuments コマンドレットを使用して、Exchange Search でインデックスを作成できなかったメールボックス、メールボックス データベース、またはメールボックス サーバーのドキュメントの一覧を取得します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Get-FailedContentIndexDocuments
[-Identity] <MailboxIdParameter>
[-Archive]
[-Confirm]
[-DomainController <Fqdn>]
[-EndDate <DateTime>]
[-ErrorCode <Int32>]
[-FailureMode <FailureMode>]
[-ResultSize <Unlimited>]
[-StartDate <DateTime>]
[-WhatIf]
[<CommonParameters>]
Get-FailedContentIndexDocuments
-MailboxDatabase <DatabaseIdParameter>
[-Confirm]
[-DomainController <Fqdn>]
[-EndDate <DateTime>]
[-ErrorCode <Int32>]
[-FailureMode <FailureMode>]
[-ResultSize <Unlimited>]
[-StartDate <DateTime>]
[-WhatIf]
[<CommonParameters>]
Get-FailedContentIndexDocuments
-Server <ServerIdParameter>
[-Confirm]
[-DomainController <Fqdn>]
[-EndDate <DateTime>]
[-ErrorCode <Int32>]
[-FailureMode <FailureMode>]
[-ResultSize <Unlimited>]
[-StartDate <DateTime>]
[-WhatIf]
[<CommonParameters>]
説明
Get-FailedContentIndexDocuments コマンドレットは、インデックスを作成できなかったドキュメントの一覧を返します。 最も一般的な理由は、そのドキュメントの種類に使用できるフィルターがなかったか、ドキュメント内に添付ファイルがあったということです。 たとえば、PDF フィルターは既定では使用できません。 メール メッセージに PDF ドキュメントが含まれている場合、PDF フィルターがないため、ドキュメントは失敗したコンテンツ インデックス作成としてマークされます。
新しいフィルターをインストールすると、フィルターがインストールされている種類の添付ファイルを含む新しいメッセージのみがインデックス付けされます。 ドキュメントの種類に対して古いメッセージのインデックスを作成する場合は、メールボックスを移動する必要があります。
コマンドレットの出力は、エラー コードやエラーの理由など、インデックスを作成できなかったメールボックス内のアイテムに関する詳細を提供します。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Get-FailedContentIndexDocuments -Identity "Terry Adams"
次の使用例は、ユーザーの Terry Adams のメールボックスから Exchange Search でインデックスを作成できなかったアイテムの一覧を取得します。
例 2
Get-FailedContentIndexDocuments -MailboxDatabase "Mailbox Database MDB2"
次の使用例は、メールボックス データベース MDB2 という名前のメールボックス データベースから Exchange Search でインデックスを作成できなかったアイテムの一覧を取得します。
パラメーター
-Archive
[アーカイブ] スイッチは、コマンドレットのスコープをユーザーのアーカイブに制限します。 このスイッチで値を指定する必要はありません。
アーカイブ スイッチを使用する場合は、Identity パラメーターも指定する必要があります。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-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, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-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, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-EndDate
EndDate パラメーターには、日付範囲の終了日を指定します。
コマンドを実行するコンピューターの [地域のオプション] 設定で定義されている短い日付形式を使用します。 たとえば、短い日付形式 mm/dd/yyyy を使用するようにコンピューターが構成されている場合は、「09/01/2018」と入力して 2018 年 9 月 1 日を指定します。 日付のみを入力したり、日付と時刻を入力することもできます。 日付と時刻を入力する場合は、値を引用符 (”) で囲む必要があります (例: "09/01/2018 5:00 PM")。
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ErrorCode
ErrorCode パラメーターを使用すると、特定のエラー コードを使用してインデックス作成に失敗したドキュメントを取得できます。 このパラメーターを指定せずにコマンドレットを使用すると、メールボックス、メールボックス データベース、またはメールボックス サーバーの失敗したすべてのドキュメントを一覧表示できます。 出力には、エラー コードとエラーの理由が含まれます。 必要に応じて、結果から特定のエラー コードに出力を制限できます。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-FailureMode
FailureMode パラメーターは、エラーの種類を指定します。 次の値を使用します。
- 一時的: 一時的なエラーのためにインデックスを作成できなかった項目を返します。 Exchange Search では、これらのアイテムのインデックスを再度作成しようとします。
- 永続的: 永続的エラーのためにインデックスを作成できなかった項目を返します。 Exchange Search では、これらのアイテムのインデックス作成は再度試行されません。
- すべて: エラーの性質に関係なくインデックスを作成できなかった項目を返します。
Type: | FailureMode |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Identity
Identity パラメーターは、表示するメールボックスを指定します。 メールボックスを一意に識別する任意の値を使用できます。 次に例を示します。
- 名前
- Alias
- 識別名 (DN)
- 正規 DN
- Domain\Username
- 電子メール アドレス
- GUID
- LegacyExchangeDN
- SamAccountName
- ユーザー ID またはユーザー プリンシパル名 (UPN)
Type: | MailboxIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-MailboxDatabase
MailboxDatabase パラメーターは、メールボックスの取得元となるデータベースを指定します。 データベースを一意に識別する、任意の値を使用できます。 以下に例を示します。
- 名前
- 識別名 (DN)
- GUID
Type: | DatabaseIdParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ResultSize
このパラメーターは、Microsoft の内部使用のために予約されています。
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Server
Server パラメーターは、メールボックス サーバーを指定します。 次の値を使用できます。
- 名前
- GUID
- Dn
Type: | ServerIdParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-StartDate
StartDate パラメーターは、日付範囲の開始日を指定します。
コマンドを実行するコンピューターの [地域のオプション] 設定で定義されている短い日付形式を使用します。 たとえば、短い日付形式 mm/dd/yyyy を使用するようにコンピューターが構成されている場合は、「09/01/2018」と入力して 2018 年 9 月 1 日を指定します。 日付のみを入力したり、日付と時刻を入力することもできます。 日付と時刻を入力する場合は、値を引用符 (”) で囲む必要があります (例: "09/01/2018 5:00 PM")。
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-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, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。