Get-SPEnterpriseSearchStatus

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

構文

Default (既定)

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

説明

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

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

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

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

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

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

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

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

Windows PowerShell for SharePoint 製品のアクセス許可と最新情報については、「SharePoint Server コマンドレット」のオンライン ドキュメントをご覧ください。

例 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

適用対象: SharePoint Server サブスクリプション エディション

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

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

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

型:SPAssignmentCollection
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Component

適用対象: SharePoint Server サブスクリプション エディション

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

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

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Constellation

適用対象: SharePoint Server サブスクリプション エディション

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

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

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Detailed

適用対象: SharePoint Server サブスクリプション エディション

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

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

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-DetailSearchRuntime

適用対象: SharePoint Server サブスクリプション エディション

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

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

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-HealthReport

適用対象: SharePoint Server サブスクリプション エディション

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

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

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-JobStatus

適用対象: SharePoint Server サブスクリプション エディション

Search Analytics および Usage Analytics タイマー ジョブの状態情報を提供する必要があるかどうかを指定します。

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

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Primary

適用対象: SharePoint Server サブスクリプション エディション

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

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

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-SearchApplication

適用対象: SharePoint Server サブスクリプション エディション

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

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

型:SearchServiceApplicationPipeBind
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Text

適用対象: SharePoint Server サブスクリプション エディション

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

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

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

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。