New-SPEnterpriseSearchServiceApplication

モジュール:
SharePointServer module

ファームに Search Service アプリケーションを追加します。

構文

Default (既定) 

New-SPEnterpriseSearchServiceApplication
    [[-Name] <String>]
    -ApplicationPool <SPIisWebServiceApplicationPoolPipeBind>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-DatabaseName <String>]
    [-DatabasePassword <SecureString>]
    [-DatabaseServer <String>]
    [-DatabaseUsername <String>]
    [-Partitioned]
    [-WhatIf]
    [-AdminApplicationPool <SPIisWebServiceApplicationPoolPipeBind>]
    [-CloudIndex <Boolean>]
    [-FailoverDatabaseServer <String>]
    [<CommonParameters>]

説明

このコマンドレットは、検索機能を最初に構成するときや、新しい共有検索アプリケーションをファームに追加するときに使用します。 SPEnterpriseSearchServiceApplication は、検索に使用できるインデックス付きコンテンツとプロパティの自己完結型の集合体を表し、グローバル検索プロパティを設定するためのアンカー クラスを提供します。 ファームには、複数の Search Service アプリケーションを追加できます。

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

例

例 1

$appPool = New-SPServiceApplicationPool -Name 'SharePoint Web Services Default' -Account 'CONTOSO\ServiceApps'
New-SPEnterpriseSearchServiceApplication -Name "Search Service Application" -ApplicationPool $appPool

この例では、新しいアプリケーション プールに NewSSA という名前の新しい検索サービス アプリケーションを作成します。

この方法で作成された Search Service アプリケーションには、アクティブな検索トポロジが割り当てられますが、検索コンポーネントは割り当てられません。

例 2

$appPool = New-SPServiceApplicationPool -Name 'SharePoint Web Services Default' -Account 'CONTOSO\ServiceApps'
New-SPEnterpriseSearchServiceApplication -Name "Search Service Application" -ApplicationPool $appPool -DatabaseName SearchServiceAppDB

この例では、新しいアプリケーション プールに NewSSA という名前の新しい検索サービス アプリケーションを作成し、データベースの名前を指定します。

この方法で作成された Search Service アプリケーションには、アクティブな検索トポロジが割り当てられますが、検索コンポーネントは割り当てられません。

パラメーター

-AdminApplicationPool

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

SearchServiceApplication に関連付けられている SearchAdminWebServiceApplication で使用されるアプリケーション プールを指定します。 指定しない場合は、ApplicationPool が使用されます。

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

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

パラメーター セット

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

-ApplicationPool

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

新しい検索アプリケーションに使用する IIS アプリケーション プールを指定します。

型は、12345678-90ab-cdef-1234-567890bcdefgh の形式の有効な GUID である必要があります。 https://server_name の形式の検索アプリケーションの有効な URL、または有効な SPIisWebServiceApplicationPool オブジェクトのインスタンス。

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

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

パラメーター セット

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

-AssignmentCollection

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

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

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

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

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

パラメーター セット

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

-CloudIndex

適用対象: SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019

CloudIndex が true の場合、これが、クラウド ハイブリッド検索ソリューションでオンプレミス コンテンツをクロールするクラウド検索サービス アプリケーションになります。

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

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

パラメーター セット

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

-Confirm

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

コマンドを実行する前に確認メッセージを表示します。 詳細については、次のコマンドを入力します。get-help about_commonparameters

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

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

パラメーター セット

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

-DatabaseName

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

新しい検索アプリケーション用に作成するデータベースの名前を指定します。

型は、SearchAppDB1 などの SQL Server データベースの有効な名前である必要があります。

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

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

パラメーター セット

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

-DatabasePassword

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

SQL Server 上の検索アプリケーション データベースへのアクセスに使用するユーザー ID のパスワードを指定します。

この型は有効なパスワードであることが必要です。

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

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

パラメーター セット

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

-DatabaseServer

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

DatabaseName で指定したデータベースのホスト サーバーの名前を指定します。

種類は、有効な SQL Server ホスト名 (SQLServerHost1 など) である必要があります。

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

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

パラメーター セット

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

-DatabaseUsername

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

検索アプリケーション SQL Server データベースへのアクセスに使用するユーザー ID を指定します。

この型は、有効なユーザー名 (SearchUserName1 など) であることが必要です。

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

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

パラメーター セット

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

-FailoverDatabaseServer

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

検索データベースのミラー インスタンスをホストする SQL サーバーの名前を指定します。

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

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

パラメーター セット

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

-Name

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

新しい検索アプリケーションの名前を指定します。

この型は、検索アプリケーションの有効な名前 (SearchApp1 など) であることが必要です。

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

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

パラメーター セット

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

-Partitioned

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

Search Service アプリケーションで Web ホスト モードを使用することを指定します。 Web ホストモードでは、特定のホスト型サブスクリプションの結果を分離します。

このプロパティは SharePoint Server 2019 には影響しません。

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

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

パラメーター セット

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

-WhatIf

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

コマンドを実行する代わりに、コマンドの実行結果を説明するメッセージを表示します。 詳細については、次のコマンドを入力します。get-help about_commonparameters

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

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

パラメーター セット

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

CommonParameters

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