导入和导出自定义搜索配置设置

项目
03/08/2023

作为 Microsoft 365 中的全局管理员或 SharePoint 管理员，您可以在租户、网站集和网站之间导出和导入自定义的搜索配置设置。导出和导入的设置包括所有自定义查询规则、结果源、结果类型、排名模型和网站搜索设置。还可以从搜索服务应用程序导出自定义搜索配置设置，并将设置导入租户、网站集或网站。无法导出默认配置设置。

概述

导出自定义搜索配置设置时，SharePoint 将会创建一个 XML 格式的搜索配置文件。此搜索配置文件包括从中开始导出的租户、网站集或网站级别的所有可导出自定义搜索配置设置。网站集的搜索配置文件不包含网站集内各个网站的搜索配置设置。

导入搜索配置文件时，SharePoint 会在从中开始导入的租户、网站集或网站中创建并启用每个自定义搜索配置设置。

下表显示了可以导出或导入的设置。对于每个设置，你将找到其他自定义搜索配置设置的依赖项。如果自定义搜索配置设置依赖于不同级别的自定义搜索配置设置（例如，网站查询规则依赖于网站集级别的结果源），那么您必须导出和导入所有相关级别的设置。

自定义搜索配置设置	对其他自定义搜索配置设置的依赖性
查询规则。这些规则包括结果块、已升级结果和用户区段。	结果源、结果类型、搜索架构、排名模型。
结果源	搜索架构
结果类型	搜索架构、结果源、显示模板
搜索架构	无
分级模型	搜索架构

可能导致导入失败的条件

如果您导入的搜索配置文件和目标具有名称相同的设置，那么当搜索配置文件遇到该设置时，将会导入失败。但是，有一些例外：

如果您重新导入搜索配置文件，搜索配置文件和目标中名称相同的设置不会导致导入失败。
如果搜索配置文件属性和目标网站属性上的各托管属性设置相同，则相同名称的托管属性不会导致导入失败。
如果已爬网属性的别名和映射与搜索配置文件和目标网站中的托管属性不同，则相同名称的托管属性不会导致导入失败。导入会将搜索配置文件中托管属性的别名和映射添加到目标网站托管属性中的别名和映射。

如果搜索配置文件包含具有无效字符的托管属性名称或别名，则在遇到该托管属性名称或别名时，导入会失败。

对于网站及其父网站集，搜索架构的托管属性名称和别名必须具有唯一性。这意味着：

如果搜索配置文件的一个托管属性名称与目标网站或目标网站父网站集上的托管属性别名相同，则导入会失败。
如果搜索配置文件的一个托管属性别名与目标网站或目标网站父网站集上的托管属性名称相同，则导入会失败。

注意

在导入失败之前由 SharePoint 创建和启用的任何自定义搜索设置将保持启用状态。

If the import fails, remove the condition that caused the failure and reimport the search configuration file. For example, if the Notes column states that there is already a query rule with the same name as the query rule that you are trying to import, then you should remove that query rule either from the target or from the import file, and then reimport the file. 请参阅本文后面的导致导入失败的无效字符。

从租户导出自定义搜索配置设置

转到 sharePoint 管理中心更多功能，并使用对组织管理员权限的帐户登录。

注意

如果使用的是由世纪互联（中国）运营的 Office 365，请登录 Microsoft 365 管理中心，然后浏览到 SharePoint 管理中心并打开“更多功能”页面。

在 “搜索”下，选择“打开”。
选择“ 导出搜索配置”。
在对话框中，选择“ 保存”。

从网站中导出自定义搜索配置设置

在网站上，选择 “，然后选择“ 网站设置”。如果未看到 “网站设置”，请选择“ 网站信息”，然后选择“ 查看所有网站设置”。
在 “网站设置” 页上的“ 搜索 ”部分中，选择“ 配置导出”。
在对话框中，选择“ 保存”。

从网站集中导出自定义搜索配置设置

在网站上，选择 “，然后选择“ 网站设置”。如果未看到 “网站设置”，请选择“ 网站信息”，然后选择“ 查看所有网站设置”。
在 “网站设置” 页上的“ 网站集管理 ”部分中，选择“ 搜索配置导出”。
在对话框中，选择“ 保存”。

将自定义搜索配置设置导入租户

转到 sharePoint 管理中心更多功能，并使用对组织管理员权限的帐户登录。

注意

如果使用的是由世纪互联（中国）运营的 Office 365，请登录 Microsoft 365 管理中心，然后浏览到 SharePoint 管理中心并打开“更多功能”页面。

在 “搜索”下，选择“ 打开”。
在 “导入搜索配置” 页上，浏览到要导入的文件。
选择“导入”。
在“搜索配置列表”页上，确认以下几点：
导入的搜索配置文件位于列表中，其状态为“已成功导入”。

如果尚未成功导入文件，则 “备注 ”列提供有关所发生情况的更多详细信息。
“ 作用域” 列显示导入的设置位于正确的级别，即在打算将文件导入到的级别。例如，如果在网站集级别而不是网站级别导入设置，则会在 “作用域 ”列中看到此信息。 The Scope column shows at which level the search configuration settings were enabled. 级别为：租户 (租户) 、网站集 (SPSite) ，或站点级别 (SPWeb) 。

将自定义搜索配置设置导入网站

在网站上，选择 “，然后选择“ 网站设置”。如果未看到 “网站设置”，请选择“ 网站信息”，然后选择“ 查看所有网站设置”。
在 “站点设置” 页上的“ 搜索 ”部分中，选择“ 配置导入”。
在 “导入搜索配置” 页上，浏览到要导入的文件。
选择“导入”。
在“搜索配置列表”页上，确认以下几点：
导入的搜索配置文件位于列表中，其状态为“已成功导入”。

如果文件未成功导入，则 “备注 ”列提供有关所发生情况的更多详细信息。
“ 作用域” 列显示导入的设置位于正确的级别，即在打算将文件导入到的级别。例如，如果在网站集级别而不是网站级别导入设置，则会在 “作用域 ”列中看到此信息。 The Scope column shows at which level the search configuration settings were enabled. 级别为：租户 (租户) 、网站集 (SPSite) ，或站点级别 (SPWeb) 。

将自定义搜索配置设置导入网站集

在网站上，选择 “，然后选择“ 网站设置”。如果未看到 “网站设置”，请选择“ 网站信息”，然后选择“ 查看所有网站设置”。
在 “网站设置” 页上的“ 网站集管理 ”部分中，选择“ 搜索配置导入”。
在 “导入搜索配置” 页上，浏览到要导入的文件。
选择“导入”。
在“搜索配置列表”页上，确认以下几点：
导入的搜索配置文件位于列表中，其状态为“ 已成功导入”。

如果文件未成功导入，则 “备注 ”列提供有关所发生情况的更多详细信息。
“ 作用域” 列显示导入的设置位于正确的级别，即在打算将文件导入到的级别。例如，如果在网站集级别而不是网站级别导入设置，则会在 “作用域 ”列中看到此信息。 The Scope column shows at which level the search configuration settings were enabled. 级别为：租户 (租户) 、网站集 (SPSite) ，或站点级别 (SPWeb) 。

导致导入失败的无效字符

如果托管属性或别名包含以下任何列出的字符，则包含这些属性的自定义搜索架构将会导入失败。

字符	名称
	空格
:	冒号
;	分号
,	逗号
(	左圆括号
)	右圆括号
[	左方括号
]	右方括号
{	左大括号
}	右大括号
%	百分号
$	美元符号
_	下划线
+	加号
!	感叹号
*	星号
=	等号
&	& 号
?	问号
@	@ 符号
#	数字记号
\	反斜杠
~	波形符
<	左尖括号
>	右尖括号
\|	竖线
`	重音符
^	脱字号
'	转义序列
"	转义序列

已知问题

无法加载搜索配置列表

将搜索配置文件导入租户管理员搜索设置页时，可能会遇到 搜索配置列表 无法正确显示的问题，并且可能会收到“找不到文件”错误。

此问题仅阻止 UI 显示导入的搜索配置文件列表，并且不会中断导入功能。搜索配置将正确导入。

由于无法检查从 UI 导入的搜索配置文件的状态，您可以选择访问列表的替代方法，例如 SharePoint CSOM API 或 SharePoint Online REST API。

无法导入过时的搜索配置 XML 文件

如果搜索配置文件是在很久以前导出的，导入可能会失败。

如果导出的搜索配置文件已过时，应首先导出新的搜索配置，然后使用它导入搜索配置文件列表。