Copilot 検索の SharePoint 権限のあるサイト

権限のあるサイトは、管理者が公式の、organization が管理する SharePoint ソースを特定するのに役立ちます。 サイトを信頼できるサイトとしてマークすると、Copilot 検索エクスペリエンスはそのコンテンツを信頼できるものとして認識します。

ユーザーにとって、この認識により、検索結果の信頼性が向上します。 From your organization ラベルなどの視覚的なシグナルにより、信頼できるアイテムを簡単に識別できます。

重要

現在のリリースでは、PowerShell および CSOM API を使用して権限のあるサイトを構成します。 構成はサイト レベルの指定をサポートしますが、個人用サイトはサポートしていません。

前提条件

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

信頼できるサイトを使用する理由

信頼できるサイトを使用して、次のことを行います。

  • 検証済みの組織ソースを宣伝することで、Copilot 検索の信頼性を向上させます。
  • ユーザーが公式コンテンツをすばやく識別できるようにします。
  • コンテンツが信頼できるかどうかを検証するのに費やす時間を短縮します。
  • 信頼できるソースの指定に対する一元的な管理者制御を維持します。

SharePoint Online 管理シェルを使用して権限のあるサイトを構成する

簡単な管理ワークフローが必要な場合は、SharePoint Online 管理シェルを使用します。

  1. モジュールをインストールしてインポートします。
  2. SharePoint 管理センターに接続します。
  3. サイトを権限のあるサイトとしてマークします。
Install-Module -Name Microsoft.Online.SharePoint.PowerShell -Force
Import-Module -Name Microsoft.Online.SharePoint.PowerShell

Connect-SPOService -Url "https://<tenant>-admin.sharepoint.com"
Set-SPOSite -Identity "https://<tenant>.sharepoint.com/sites/<siteName>" -IsAuthoritative $true

CSOM を使用した権限のあるサイトの構成 (高度)

自動化または一括操作が必要な場合は CSOM を使用します。

注:

CSOM バージョン 16.1.26914.12004 以降が必要です。

手順 1: PnP PowerShell をインストールする

Install-Module PnP.PowerShell -Scope CurrentUser -Force

手順 2: Microsoft Entra ID アプリを登録する

対話型認証用にアプリを登録し、出力からクライアント ID をコピーします。

$tenant = "<TenantName>.onmicrosoft.com"
Register-PnPEntraIDAppForInteractiveLogin -ApplicationName "PnP Interactive (SPO Admin)" -Tenant $tenant -SharePointDelegatePermissions "AllSites.FullControl" -SharePointApplicationPermissions "Sites.FullControl.All" -GraphDelegatePermissions "Sites.FullControl.All" -GraphApplicationPermissions "Sites.FullControl.All" -Interactive
$clientId = "<FROM ABOVE OUTPUT>"

手順 3: SharePoint Online をインストールする CSOM

Install-Package Microsoft.SharePointOnline.CSOM -Source nuget.org -Scope CurrentUser

手順 4: CSOM アセンブリを読み込む

$dllPath = "C:\Users\<USER_NAME>\AppData\Local\PackageManagement\NuGet\Packages\Microsoft.SharePointOnline.CSOM.<VERSION>\lib\netstandard2.0"
Add-Type -Path "$dllPath\Microsoft.SharePoint.Client.dll"
Add-Type -Path "$dllPath\Microsoft.SharePoint.Client.Runtime.dll"
Add-Type -Path "$dllPath\Microsoft.Online.SharePoint.Client.Tenant.dll"

手順 5: SharePoint Online に接続する

$tenantDomain = "<TenantName>.onmicrosoft.com"
Connect-PnPOnline -Url "https://<TenantName>-admin.sharepoint.com" -ClientId $clientId -Tenant $tenantDomain -Interactive

手順 6: テナント オブジェクトを初期化し、API の可用性を確認する

$ctx = Get-PnPContext
$tenant = New-Object Microsoft.Online.SharePoint.TenantAdministration.Tenant($ctx)
$ctx.ExecuteQuery()

$tenant.GetType().GetMethod("GetAuthoritativeResources")

CSOM の操作

信頼できるサイトを取得する

$authResources = $tenant.GetAuthoritativeResources()
$ctx.ExecuteQuery()

サイトを信頼できるサイトとしてマークする

$siteId = [Guid]"<SiteId>"
$result = $tenant.SetResourceAsAuthoritative($siteId)
$ctx.ExecuteQuery()
$result.Value

権限のあるサイトからサイトを削除する

$siteId = [Guid]"<SiteId>"
$result = $tenant.RemoveResourceAsAuthoritative($siteId)
$ctx.ExecuteQuery()

サイトが正常に削除された場合、応答は空になります。 操作が失敗した場合、PowerShell は例外を返します。

サイトを信頼できるサイトとして一括マークする

[System.Guid[]]$siteIds = @([Guid]"<SiteId1>", [Guid]"<SiteId2>", [Guid]"<SiteId3>")
$results = $tenant.BulkSetResourceAsAuthoritative($siteIds)
$ctx.ExecuteQuery()
$results

信頼できるサイトを一括削除する

[System.Guid[]]$siteIds = @([Guid]"<SiteId1>", [Guid]"<SiteId2>", [Guid]"<SiteId3>")
$results = $tenant.BulkRemoveResourceAsAuthoritative($siteIds)
$ctx.Load($results)
$ctx.ExecuteQuery()
$results

ライフサイクルとメンテナンス

信頼できるソースのライブ セットとして信頼できるサイトを維持する:

  • リストを定期的に確認し、古いサイトや非公式サイトを削除してください。
  • サイトの削除または復元イベント後の動作を検証します。
  • 更新後の伝搬時間を計画します。

制限事項

  • 最大 100 のサイトを権限のあるサイトとしてマークできます。
  • 変更がサポートされているエクスペリエンスに反映されるまでに最大 72 時間かかる場合があります。
  • 指定は現在、サイト レベルのみです。
  • 複数地域のテナントは、地域ごとに権限のあるサイト データを管理します。
  • 個人用サイトを権限のあるサイトとしてマークすることはできません。

トラブルシューティング

変更が期待どおりに表示されない場合は、次の項目をチェックします。

  • ライセンス: Microsoft Copilot ライセンスが必要です。 ( 「SharePoint の高度な管理の前提条件」を参照してください。)
  • 機能の可用性: テナントで機能が有効になっていることを確認してください。
  • サイトの適格性: URL が有効であり、サポートされている SharePoint サイトを参照していることを確認してください。
  • タイミング: 伝播に十分な時間 (最大 72 時間) を考慮します。