制限付き SharePoint Search に PowerShell スクリプトを使用する

重要

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

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

PowerShell スクリプトを使用して制限付き SharePoint Search を有効にして管理する方法

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

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

開始する前に

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

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

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

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

Get-SPOTenantRestrictedSearchMode

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

適用対象:SharePoint Online

構文

Get-SPOTenantRestrictedSearchMode

Get-SPOTenantRestrictedSearchMode

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

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

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 Search を有効にする場合は、次のコマンドを使用して、文字列または CSV ファイルの許可リストにサイト URL を追加します。

Add-SPOTenantRestrictedSearchAllowedList

Module: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 オンライン管理センターに移動し、[ アクティブなサイト] に移動し、[ エクスポート] を選択します。 エクスポートされた一覧には、クラシック サイトも含まれます。 インデックスを作成しないサイトをこの一覧から削除します。 最大 100 個の URL を含めることができます。

この例では、CSV ファイルを指定してサイトを許可リストに追加する方法を管理者に示します。 [URL] 列にサイト URL の一覧を追加します。

Parameters

-SitesList

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

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

-SitesListFileURL

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

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

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

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

Remove-SPOTenantRestrictedSearchAllowedList

Module: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

Module:Microsoft.Online.SharePoint.PowerShell

適用対象:SharePoint Online

構文

Get-SPOTenantRestrictedSearchAllowedList

Get-SPOTenantRestrictedSearchAllowedList

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