制限付き SharePoint 検索に PowerShell スクリプトを使用する
重要
制限付き SharePoint Search は、Microsoft 365 Copilotのお客様向けに設計されています。 詳細については、こちらのおよび制限付き SharePoint 検索の概要に関するページを参照してください。
既定では、 制限付き SharePoint Search は有効になっていません。 制限付き SharePoint Search を有効にして設定するには、Microsoft 365 で SharePoint 管理者以上のロールが必要です。 シナリオに応じて、次のアクションを実行する必要があります。
制限付き検索に設定されている現在のモードを取得する
制限付き SharePoint 検索を有効または無効にする
URL を指定して許可リストにサイトを追加する
URL を指定して許可リストからサイトを削除する
許可リストに追加された URL の既存の一覧を取得する
この記事では、これらのアクションに PowerShell で管理スクリプトを使用する方法について説明します。
始める前に
次の管理スクリプトを実行するには、Microsoft 365 の SharePoint 管理者以上である必要があります。 この記事の PowerShell スクリプトを使用する前に、次の操作を行う必要があります。
まだダウンロードしていない場合は、 最新の SharePoint Online 管理シェルをダウンロードします。
注:
SharePoint Online 管理シェルの以前のバージョンがインストールされている場合は、[プログラムの追加と削除] に移動して、"SharePoint Online 管理シェル" をアンインストールします。
Microsoft 365 の Microsoft 365 でSharePoint 管理者以上として SharePoint に接続します。 方法の詳細については、「SharePoint Online 管理シェルの使用を開始する」を参照してください。
制限付き検索に設定されている現在のモードを取得する
制限付き SharePoint Search は既定で無効になっています。 この機能の現在のモードを確認するには、次のスクリプトを実行します。
Get-SPOTenantRestrictedSearchMode
モジュール: Microsoft.Online.SharePoint.PowerShell
適用対象:SharePoint Online
構文
Get-SPOTenantRestrictedSearchMode
例
Get-SPOTenantRestrictedSearchMode
この例では、管理者がテナント内の既存の許可リストを取得できるようにします。 結果は、現在の設定に基づいて [有効] または [無効] にすることができます。
制限付き検索設定を有効または無効にする
[制限付き検索] 設定を有効または無効にし、既定値を無効にします。 設定を初めて有効にすると、許可リストが空になります。 制限付き 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 では、テナントの制限付きテナント検索モードを無効にします。
パラメーター
-モード
制限付きテナント検索のモードを設定します。
| 型 | String |
|---|---|
| 立場： | 0 |
| 既定値： | 無効 |
| 必須: | はい |
| パイプライン入力を受け入れる: | 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
この例では、管理者が CSV ファイルを指定することで、許可されたリストにサイトを追加できます。 [URL] 列にサイト URL の一覧を追加します。
パラメーター
-SitesList
許可リストのサイト 一覧。
| 型 | String |
|---|---|
| 立場： | 0 |
| 既定値： | なし |
| 必須: | はい |
| パイプライン入力を受け入れる: | False |
| ワイルドカード文字を受け入れます。 | False |
-SitesListFileURL
テナントが制限付きテナント検索モードに設定されている場合に許可リストに追加できるサイト URL の一覧を含むファイル。
| 型 | String |
|---|---|
| 立場： | 0 |
| 既定値： | なし |
| 必須: | はい |
| パイプライン入力を受け入れる: | 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 ファイルを指定して、許可されたリストにサイトを追加できます。
パラメーター
-SitesList
許可リストから削除されるサイト リスト。
| 型 | String |
|---|---|
| 立場： | 0 |
| 既定値： | なし |
| 必須: | はい |
| パイプライン入力を受け入れる: | False |
| ワイルドカード文字を受け入れます。 | False |
-SitesListFileURL
テナントが制限付きテナント検索モードに設定されている場合に許可リストから削除できるサイトの一覧を含むファイル。
| 型 | String |
|---|---|
| 立場： | 0 |
| 既定値： | なし |
| 必須: | はい |
| パイプライン入力を受け入れる: | False |
| ワイルドカード文字を受け入れます。 | False |
許可リスト内の URL の既存の一覧を取得する
次の PowerShell スクリプトを実行すると、許可されている一覧の URL の既存の一覧を取得できます。
Get-SPOTenantRestrictedSearchAllowedList
Module:Microsoft.Online.SharePoint.PowerShell
適用対象:SharePoint Online
構文
Get-SPOTenantRestrictedSearchAllowedList
```
**Example**
```powershell
Get-SPOTenantRestrictedSearchAllowedList
この例では、管理者がテナント内の既存の許可リストを取得できるようにします。