制限された SharePoint 検索に PowerShell スクリプトを使用する

重要

制限付き SharePoint 検索は廃止されます。 2026 年 7 月 31 日以降、新しい有効化はブロックされます。 コンテンツの検出可能性については、 制限付きコンテンツ検出 (RCD) などの包括的なデータ制御を使用します。

制限付き SharePoint 検索は、Microsoft Copilot Chat およびエージェント エクスペリエンスの顧客向けに設計されています。 これは、organization の管理者がサイトとファイルのアクセス許可を徹底的に確認および監査する時間を与えるための短期的なソリューションとして設計されていますが、長期使用を目的としたものではなく、スケーラブルではありません。 SharePoint 高度な管理Microsoft Purview など、包括的なデータ セキュリティ ソリューションを利用できます。

PowerShell スクリプトを使用して制限された SharePoint 検索を有効にして管理する方法

既定では、制限付き SharePoint 検索は有効になっていません。 制限付き SharePoint 検索を有効にして設定するには、少なくとも Microsoft 365 の SharePoint 管理者 のアクセス許可が必要です。 シナリオに応じて、次のようなアクションを実行する必要があります。

この記事では、これらのアクションのために PowerShell で管理スクリプトを使用する方法について説明します。

開始する前に

PowerShell 管理スクリプトを実行するには、 SharePoint 管理者 であるか、Microsoft 365 で同等のアクセス許可を持っている必要があります。

SharePoint の高度な管理の前提条件を参照してください。

この記事の PowerShell スクリプトを使用する前に、「 SharePoint Online PowerShell モジュールの要件」を参照してください。

制限付き SharePoint 検索は既定で無効になっています。 この機能の現在のモードを確認するには、次のコマンドを実行します。

Get-SPOTenantRestrictedSearchMode

モジュール: Microsoft.Online.SharePoint.PowerShell

適用対象:SharePoint Online

構文

Get-SPOTenantRestrictedSearchMode

Get-SPOTenantRestrictedSearchMode

この例では、管理者はテナント内の既存の許可リストを取得できます。 現在の設定に基づいて、結果は "有効" または "無効" にすることができます。

制限付き検索の設定を有効または無効にします。 既定値は disabled です。 初めてこの設定を有効にした場合、許可リストは空になります。 制限された SharePoint 検索を有効または無効にするには、次のコマンドを実行します。

Set-SPOTenantRestrictedSearchMode

モジュール: Microsoft.Online.SharePoint.PowerShell

適用対象:SharePoint Online

構文

Set-SPOTenantRestrictedSearchMode 
[-Mode] {Disabled | Enabled}
 [<CommonParameters>]

例 1

Set-SPOTenantRestrictedSearchMode -Mode Enabled  

注:

有効にすると、新しいサイトは許可リストに追加しない限り除外されます。

例 1 では、テナントの制限付きテナント検索モードを設定または有効にします。

例 2

Set-SPOTenantRestrictedSearchMode – Mode Disabled  

例 2 では、テナントの制限付きテナント検索モードが無効になります。

Parameters

-Mode

制限付きテナント検索のモードを設定します。

String
役職: 0
既定値: Disabled
必須: True
パイプライン入力を受け入れる: False
ワイルドカード文字を受け入れる: False

許可リストにサイトを追加する

制限付き SharePoint 検索を有効にする場合は、次のコマンドを使用して、サイト URL を文字列または CSV ファイルの許可リストに追加します。

Add-SPOTenantRestrictedSearchAllowedList

モジュール:Microsoft.Online.SharePoint.PowerShell

適用対象:SharePoint Online

構文

Add-SPOTenantRestrictedSearchAllowedList -SitesList <List[string]> [<CommonParameters>]
Add-SPOTenantRestrictedSearchAllowedList -SitesListFileUrl <string> [-ContainsHeader <bool>]  
 [<CommonParameters>]

例 1

Add-SPOTenantRestrictedSearchAllowedList -SitesList @("[https://contoso.sharepoint.com/sites/Marketing](https://contoso.sharepoint.com/sites/Marketing)", "[https://contoso.sharepoint.com/sites/Benefits](https://contoso.sharepoint.com/sites/Benefits)")

この例では、許可リストにサイトを追加する方法を管理者に示します。

例 2

Add-SPOTenantRestrictedSearchAllowedList  -SitesListFileUrl C:\Users\admin\Downloads\UrlList.csv

注:

すべての SharePoint サイト URL の一覧を生成するには、SharePoint Online 管理センターに移動し、[ アクティブ サイト] に移動して、[ エクスポート] を選択します。 エクスポートされた一覧には、クラシック サイトも含まれます。 インデックスを作成しないサイトをこの一覧から削除します。 URL は最大 100 個まで含めることができます。

この例では、CSV ファイルを提供して許可リストにサイトを追加する方法が管理者に示されています。 [URL] 列にサイト URL のリストを追加します。

Parameters

-SitesList

許可リストのサイト一覧。

String
役職: 0
既定値: None
必須: True
パイプライン入力を受け入れる: False
ワイルドカード文字を受け入れる: False

-SitesListFileURL

テナントが制限付きテナント検索モードに設定されている場合に許可リストに追加できるサイト URL の一覧を含むファイル。

String
役職: 0
既定値: None
必須: True
パイプライン入力を受け入れる: False
ワイルドカード文字を受け入れる: False

許可リストからサイトを削除する

次の PowerShell コマンドを使用して、サイト URL を文字列または CSV ファイルに指定することで、許可リストからサイトを削除します。

Remove-SPOTenantRestrictedSearchAllowedList

モジュール:Microsoft.Online.SharePoint.PowerShell

適用対象:SharePoint Online

構文

Remove-SPOTenantRestrictedSearchAllowedList -SitesList <List[string]> [<CommonParameters>]
Remove-SPOTenantRestrictedSearchAllowedList -SitesListFileUrl <string> [-ContainsHeader <bool>]
 [<CommonParameters>]

例 1

Remove-SPOTenantRestrictedSearchAllowedList -SitesList @("[https://contoso.sharepoint.com/sites/Marketing](https://contoso.sharepoint.com/sites/Marketing)", "[https://contoso.sharepoint.com/sites/HR](https://contoso.sharepoint.com/sites/HR)")

例 1 は、管理者が許可リストからサイトを削除する方法を示しています。

例 2

Remove-SPOTenantRestrictedSearchAllowedList -SitesListFileUrl C:\Users\admin\Downloads\UrlList.csv

例 2 は、管理者が CSV ファイルを提供して許可リストにサイトを追加する方法を示しています。

Parameters

-SitesList

許可リストから削除するサイト リスト。

String
役職: 0
既定値: None
必須: True
パイプライン入力を受け入れる: False
ワイルドカード文字を受け入れる: False

-SitesListFileURL

テナントが制限付きテナント検索モードに設定されている場合に許可リストから削除できるサイトの一覧を含むファイル。

String
役職: 0
既定値: None
必須: True
パイプライン入力を受け入れる: False
ワイルドカード文字を受け入れる: False

許可リスト内の URL の既存の一覧を取得する

許可リスト内の URL の既存の一覧を取得するには、次の PowerShell コマンドを実行します。

Get-SPOTenantRestrictedSearchAllowedList

モジュール:Microsoft.Online.SharePoint.PowerShell

適用対象:SharePoint Online

構文

Get-SPOTenantRestrictedSearchAllowedList

Get-SPOTenantRestrictedSearchAllowedList

この例では、管理者がテナントの既存の許可リストを取得する方法を示します。