在 SharePoint 中设置 Web 和场级必应地图密钥

项目
03/21/2023

操作方法主题

了解如何使用 SharePoint 客户端对象模型和Windows PowerShell，以编程方式在 Web (SharePoint Server 和 SharePoint Online) ) 和服务器场 (级别设置必应地图密钥，以便在 SharePoint 列表和基于位置的 Web 和移动应用中启用必应地图功能。

设置 Bing 地图密钥的先决条件

若要遵循此示例中的这些步骤，您应具备以下组件：

SharePoint - 在场或网站集级别具有管理权限
SharePoint Online Management Shell - https://www.microsoft.com/download/details.aspx?id=35588
SharePoint Online PnP PowerShell - https://github.com/SharePoint/PnP-PowerShell/
Visual Studio 2010 或更高版本
可从必应地图帐户中心获取的有效必应地图密钥。

重要

请注意您必须遵守使用 Bing 地图密钥的条款和条件，以及将任何与传递到 Bing 地图服务的数据有关的信息透露给应用程序用户的相关条款和条件。

注意

PnP PowerShell 是一种开放源代码解决方案，其中包含为其提供支持的活动社区。没有用于 Microsoft 开放源代码工具支持的 SLA。

代码示例：在场或 Web 一级设置必应地图密钥

可以设置场或 Web 级别的 Bing 地图密钥。若要设置场级别的 Bing 地图密钥，您需要对该服务器具备管理员权限；然后，您可以通过使用 SharePoint 命令行管理程序添加密钥。若要在 Web 级别设置必应地图密钥，请编写使用 SharePoint 客户端对象模型或利用 SharePoint PnP PowerShell 的控制台应用程序。

提示

与在场级别设置的 Bing 地图密钥相比，在 Web 级别设置的此密钥具有更高的优先级顺序。

使用 Windows PowerShell 在场一级设置必应地图密钥的具体步骤

以管理员身份登录到 SharePoint 服务器，然后打开 SharePoint 命令行管理程序。
执行以下命令：

Set-SPBingMapsKey -BingKey "<Enter a valid Bing Maps key>"

现已在 SharePoint 中的场一级设置必应地图密钥。

注意

使用 Windows PowerShell 时，只能在场一级设置必应地图密钥。若要在 Web 一级设置必应地图密钥，可以编程方式设置密钥，如下面的部分所述。

使用 SharePoint PnP PowerShell 在 Web 级别设置必应地图键

打开 SharePoint Online Management Shell
连接到要添加/更新必应地图密钥的站点

Connect-PnPOnline -url "https://TENANT.sharepoint.com/sites/SITEURL"

将必应地图密钥添加到 Site 属性包 (更新“YOURKEYVALUE”)

Set-PnPPropertyBagValue -Key "BING_MAPS_KEY" -Value "YOURKEYVALUE"

如果收到有关启用 NoScript 的错误，则必须在站点中禁用它。然后重新运行步骤 3。

Set-PnPSite -NoScriptSite $false

注意

确保了解更改网站的 NoScript 策略 - 允许或阻止自定义脚本的含义。

使用 Visual Studio 的客户端对象模型在场或 Web 级别设置必应地图键

启动 Visual Studio。
在菜单栏上，选择"文件"、"新建项目"。将打开"新建项目"对话框。
在"新建项目"对话框中，在"已安装的模板"框中选择"C#"，然后选择"控制台应用程序"模板。
给项目命名，然后选择"确定"按钮。
Visual Studio 创建此项目。向以下程序集添加引用，并选择"确定"。

Microsoft.SharePoint.Client.dll
Microsoft.SharePoint.Client.Runtime.dll

在默认 .cs 文件中，添加以下 using 指令。 using Microsoft.SharePoint.Client;
在 .cs 文件中向主方法添加以下代码。


class Program
    {
        static void Main(string[] args)
        {
            SetBingMapsKey();
            Console.WriteLine("Bing Maps set successfully");
        }
     static private void SetBingMapsKey()
        {

            ClientContext context = new ClientContext("<Site Url>");
            Web web = context.Web;
            web.AllProperties["BING_MAPS_KEY"] = "<Valid Bing Maps Key>"
            web.Update();
            context.ExecuteQuery();
        }
    }

将<“网站 URL”>和<“有效必应地图密钥>”替换为有效值。
在"项目属性"中将目标框架设置为 .NET Framework 4.0，并运行该示例。
应立即在 Web 级别设置该密钥。

后续步骤

若要了解使用 SharePoint 中的位置和映射功能的详细信息，请参阅以下信息：

Share via