SharePoint の Web とファーム レベルで Bing Maps キーを設定する

  • [アーティクル]

操作手順のトピック

SharePoint クライアント オブジェクト モデルとWindows PowerShellを使用して、Web (SharePoint Server および SharePoint Online) レベルおよびファーム (SharePoint Server) レベルでプログラムによってBing地図 キーを設定し、SharePoint リストと場所ベースの Web およびモバイル アプリでBing地図機能を有効にする方法について説明します。

Bing Maps キーを設定する場合の前提条件

この例で示す手順を実行するには、次の前提条件を満たす必要があります。

重要

Bing Maps キーの使用にあたっては、利用規約を遵守する義務を負い、Bing Maps サービスに渡されたデータに関しては、アプリケーションの使用者への開示義務を負うものとします。

注:

PnP PowerShell はオープン ソース ソリューションであり、アクティブなコミュニティでサポートが提供されています。 Microsoft からのオープン ソース ツールのサポート SLA はありません。

コード例: Bing Maps キーをファーム レベルまたは Web レベルで設定する

Bing地図 キーは、ファームまたは Web レベルで設定できます。 ファーム レベルでBing地図 キーを設定するには、サーバーの管理者権限が必要です。その後、SharePoint 管理シェルを使用してキーを追加できます。 Bing地図 キーを Web レベルで設定するには、SharePoint クライアント オブジェクト モデルを使用するコンソール アプリケーションを作成するか、SharePoint PnP PowerShell を利用します。

ヒント

Web レベルで設定された Bing Maps キーは、ファーム レベルで設定された Bing Maps キーより優先順位が高くなります。

Windows PowerShell を使用してファーム レベルで Bing Maps キーを設定するには

  1. SharePoint サーバーに管理者としてログオンし、SharePoint 管理シェルを開きます。

  2. 次のコマンドを実行します。

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

    これで、Bing Maps キーが SharePoint のファーム レベルで設定されます。

注:

Windows PowerShell を使用する場合、Bing Maps キーはファーム レベルでのみ設定できます。 Bing Maps キーを Web レベルで設定する場合は、次のセクションに示すようにプログラムによってキーを設定します。

SharePoint PnP PowerShell を使用して web レベルでBing地図 キーを設定するには

  1. SharePoint Online 管理シェルを開きます
  2. Bing地図 キーを追加または更新するサイトに接続する
Connect-PnPOnline -url "https://TENANT.sharepoint.com/sites/SITEURL"
  1. サイト プロパティ バッグに Bing地図 キーを追加する ("YOURKEYVALUE" を更新する)
Set-PnPPropertyBagValue -Key "BING_MAPS_KEY" -Value "YOURKEYVALUE"
  1. NoScript が有効になっているかどうかに関するエラーが表示される場合は、サイトで無効にする必要があります。 次に、手順 3 を再実行します。
Set-PnPSite -NoScriptSite $false

注:

サイトの NoScript ポリシーの変更の影響を理解していることを確認する - カスタム スクリプトを許可または禁止します。

Visual Studio でクライアント オブジェクト モデルを使用してファームまたは Web レベルでBing地図 キーを設定するには

  1. Visual Studio を起動します。

  2. メニュー バーで、[ ファイル]、[ 新しいプロジェクト] を選択します。 [新しいプロジェクト] ダイアログ ボックスが開きます。

  3. [ 新しいプロジェクト] ダイアログ ボックスの [ インストールされたテンプレート] ボックスで [ C#] を選択して、[ コンソール アプリケーション] テンプレートを選択します。

  4. プロジェクトに名前をつけて、[ OK] をクリックします。

  5. Visual Studio がプロジェクトを作成します。 参照を次のアセンブリに追加し、[ OK] を選択します。

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

  1. 既定の .cs ファイルに、次のようにして using ディレクティブを追加します。 using Microsoft.SharePoint.Client;

  2. .cs ファイルの Main メソッドに次のコードを追加します。


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();
        }
    }
  1. [サイト URL] <と <[有効なBing地図 キー] を>>有効な値に置き換えます。
  2. [プロジェクトのプロパティ] でターゲット フレームワークを [.NET Framework 4.0] として設定し、サンプル コードを実行します。
  3. これで、キーが Web レベルで設定されます。

次の手順

SharePoint での場所およびマップ機能の使用法の詳細については、以下を参照してください。