Get-SPEnterpriseSearchStatus

検索コンポーネントの診断情報を取得します。

構文

Get-SPEnterpriseSearchStatus
   -SearchApplication <SearchServiceApplicationPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Component <String>]
   [-Constellation]
   [-Detailed]
   [-DetailSearchRuntime]
   [-HealthReport]
   [-JobStatus]
   [-Primary]
   [-Text]
   [<CommonParameters>]

説明

このコマンドレットは、Search Service アプリケーションのアクティブなトポロジ内のすべての検索コンポーネントまたは指定された検索コンポーネントの診断情報を取得します。

省略可能なパラメーターを指定しない場合、コマンドレットは Search Service アプリケーション内のすべての検索コンポーネントの正常性状態を取得します。 各検索コンポーネントには、次のいずれかの状態があります。

  • アクティブ: 検索コンポーネントが OK を実行しています
  • 機能低下: 検索コンポーネントは、すべての操作を正しく実行できない状態です。 状態が低下する理由は、通常、再起動またはネットワークの問題に関連する一時的な状況です。
  • 失敗: 検索コンポーネントが実行されていません。 この状態は、コンポーネントが操作を正しく実行できないことを示しました。
  • 不明: コンポーネントに到達できません。 不明な状態の理由は、通常、ハードウェアまたは通信の問題です。

検索トポロジ内のパーティションに対して複数の Index コンポーネントを定義している場合、このコマンドレットは、このパーティションのプライマリ ロールを持つインデックス コンポーネントを示します。

コマンドレットを使用して、次の追加情報を出力できます。

  • 検索コンポーネントによって開始されたバックグラウンド アクティビティ (バッチ ジョブ) の状態を一覧表示する
  • 検索コンポーネントによって開始されたバックグラウンド アクティビティ (バッチ ジョブ) の状態を一覧表示する
  • インデックス コンポーネントの詳細な診断情報を一覧表示する
  • 問題の詳細な解決のためにMicrosoftによって使用されるデバッグ情報

スクリプト内の出力を反復処理しない場合は、Text パラメーターを使用します。 Text パラメーターを使用しない場合、コマンドレットは次のプロパティを持つオブジェクトのセットを出力します。

  • string Name: 検索コンポーネント、正常性レポート アイテム、または星座プロパティの名前
  • string State: 検索コンポーネントの状態
  • string Level: HealthReport パラメーターを使用している場合、このプロパティは各正常性レポート アイテムの重要度レベルを示します (エラー、警告、情報、詳細)
  • string メッセージ: テキスト文字列として提供される追加情報
  • ReadOnlyDictionary<文字列,文字列>の詳細: 追加の診断情報を提供するディクショナリの名前と値のペア

SharePoint 製品のWindows PowerShellに関するアクセス許可と最新の情報については、 のオンライン ドキュメントを参照してくださいhttps://go.microsoft.com/fwlink/p/?LinkId=251831

------------------ 例 1 ------------------

Get-SPEnterpriseSearchServiceApplication | Get-SPEnterpriseSearchStatus -Text

次の使用例は、既定の Search Service アプリケーションのすべての検索コンポーネントに関する診断情報を含むリストを取得します。

------------------ 例 2 ------------------

Get-SPEnterpriseSearchStatus -SearchApplication 'Search Service Application' -JobStatus -Text

次の使用例は、検索分析タイマー ジョブのバックグラウンド アクティビティ ジョブの状態を取得します。

------------------ 例 3 ------------------

Get-SPEnterpriseSearchServiceApplication | Get-SPEnterpriseSearchStatus -HealthReport -Component IndexComponent1 -Text

次の使用例は、IndexComponent1 という名前のインデックス コンポーネントの診断情報を取得します。

パラメーター

-AssignmentCollection

適切な破棄を行うためにオブジェクトを管理します。 SPWeb や SPSite などのオブジェクトの使用によって大量のメモリが使用される場合があるので、Windows PowerShell スクリプトでこれらのオブジェクトを使用するには適切なメモリ管理が必要です。 メモリの解放が必要になった場合は、SPAssignment オブジェクトを使用して、変数へのオブジェクトの割り当てとオブジェクトの破棄を行うことができます。 割り当てコレクションまたは Global パラメーターが使用されていない場合、SPWeb、SPSite、または SPSiteAdministration オブジェクトが使用されていると、オブジェクトは自動的に破棄されます。

Global パラメーターが使用されている場合は、オブジェクトはすべてグローバル ストアに格納されます。 Stop-SPAssignment コマンドを使用してオブジェクトの使用または破棄を直接行わないと、メモリ不足のシナリオになる場合があります。

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Component

検索コンポーネントの名前を指定します。 このパラメーターは、HealthReport パラメーターと Primary パラメーターとの関連付けでのみ使用されます。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Constellation

検索トポロジの内部診断情報を提供するかどうかを指定します。 このパラメーターはデバッグにのみ使用する必要があります。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Detailed

HealthReport パラメーターの詳細レベルを指定します。 このパラメーターを使用すると、コマンドレットによって詳細な診断情報も出力されます。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DetailSearchRuntime

検索ランタイムの内部診断情報を指定するかどうかを指定します。 このパラメーターはデバッグにのみ使用する必要があります。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-HealthReport

検索コンポーネントの診断情報を指定するかどうかを指定します。 このパラメーターを使用する場合は、Component パラメーターを使用してコンポーネント名を指定する必要があります。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-JobStatus

Search Analytics タイマー ジョブと Usage Analytics タイマー ジョブの状態情報を指定するかどうかを指定します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Primary

管理 コンポーネントにプライマリ ロールがあるかどうかを指定します。 このパラメーターを使用する場合は、Component パラメーターを使用してコンポーネント名を指定する必要があります。 管理 コンポーネントにプライマリ ロールがある場合は true を返します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SearchApplication

検索コンポーネントを含む検索サービス アプリケーションを指定します。

Type:SearchServiceApplicationPipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Text

このコマンドレットからの出力を読み取りに便利な形式で出力するかどうかを指定します。 使用しない場合、このコマンドレットは SearchStatusInfo オブジェクトを出力します。

このパラメーターを使用すると、出力はコンソールに出力され、ファイルまたは別のプログラムにパイプすることはできません。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019