Share via

Festlegen des Bing Maps-Schlüssels auf Web- und Farmebene in SharePoint

  • Artikel

Thema mit Anleitung

Erfahren Sie, wie Sie den Bing Karten Schlüssel programmgesteuert im Web (SharePoint Server und SharePoint Online) und auf Farmebene (SharePoint Server) festlegen, indem Sie das SharePoint-Clientobjektmodell und Windows PowerShell verwenden, um die Bing Karten-Funktionalität in SharePoint-Listen und standortbasierten Web- und mobilen Apps zu aktivieren.

Erforderliche Komponenten für die Festlegung des Bing Maps-Schlüssels

Zum Ausführen der Schritte in diesem Beispiel sollten Sie über Folgendes verfügen:

Wichtig

Bitte beachten Sie, dass Sie für die Einhaltung der geschäftsbedingungen verantwortlich sind, die für Ihre Verwendung des Bing Karten-Schlüssels gelten, sowie für alle erforderlichen Offenlegungen gegenüber Benutzern Ihrer Anwendung in Bezug auf Daten, die an den Bing Karten-Dienst übergeben werden.

Hinweis

PnP PowerShell ist eine Open Source-Lösung mit aktiver Community, die Support dafür bietet. Es gibt keine SLA für den Support des Open-Source-Tools durch Microsoft.

Codebeispiel: Einrichten des Bing Maps-Schlüssels auf Farm- oder Webebene.

Ebene der Farm oder Web kann der Bing Maps-Schlüssel festgelegt werden. Um den Bing Maps-Schlüssel auf Farmebene festgelegt, benötigen Sie Administratorrechte auf dem Server; Sie können den Schlüssel dann mithilfe der SharePoint-Verwaltungsshell hinzufügen. Um den Bing Karten Schlüssel auf Webebene festzulegen, schreiben Sie eine Konsolenanwendung, die das SharePoint-Clientobjektmodell verwendet, oder nutzen Sie SharePoint PnP PowerShell.

Tipp

Der auf Webebene festgelegte Bing Karten Schlüssel hat eine höhere Rangfolge als der auf Farmebene festgelegte Bing Karten Schlüssel.

Verwenden Sie Windows PowerShell, um den Bing Maps-Schlüssel auf der Farbebene festzulegen.

  1. Melden Sie sich an den SharePoint-Server als Administrator, und öffnen Sie die SharePoint-Verwaltungsshell.

  2. Führen Sie den folgenden Befehl aus:

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

    Der Bing Maps-Schlüssel wird nun auf der Farmebene in SharePoint festgelegt.

Hinweis

Wenn Sie Windows PowerShell verwenden, kann der Bing Maps-Schlüssel nur auf der Farmebene festgelegt werden. Wenn Sie den Bing Maps-Schlüssel auf der Webebene festlegen möchten, können Sie den Schlüssel, wie im folgenden Abschnitt beschrieben, programmgesteuert festlegen.

So legen Sie den Bing Karten-Schlüssel auf Webebene mit SharePoint PnP PowerShell fest

  1. Öffnen Sie die SharePoint Online-Verwaltungsshell.
  2. Stellen Sie eine Verbindung mit dem Standort her, an dem Sie den Bing Karten-Schlüssel hinzufügen oder aktualisieren möchten.
Connect-PnPOnline -url "https://TENANT.sharepoint.com/sites/SITEURL"
  1. Hinzufügen des Bing Karten-Schlüssels zum Eigenschaftenbehälter "Site" (Aktualisieren von "YOURKEYVALUE")
Set-PnPPropertyBagValue -Key "BING_MAPS_KEY" -Value "YOURKEYVALUE"
  1. Wenn Sie eine Fehlermeldung bezüglich der Aktivierung von NoScript erhalten, müssen Sie sie auf der Website deaktivieren. Führen Sie dann Schritt 3 erneut aus.
Set-PnPSite -NoScriptSite $false

Hinweis

Stellen Sie sicher, dass Sie die Auswirkungen der Änderung der NoScript-Richtlinie einer Website verstehen– Zulassen oder Verhindern eines benutzerdefinierten Skripts.

So legen Sie den Bing Karten Schlüssel auf Farm- oder Webebene mithilfe des Clientobjektmodells mit Visual Studio fest

  1. Starten Sie Visual Studio.

  2. Wählen Sie auf der Menüleiste Datei, Neues Projekt aus. Das Dialogfeld Neues Projekt wird geöffnet.

  3. Klicken Sie im Dialogfeld Neues Projekt wählen Sie c# im Feld Installierte Vorlagen, und wählen Sie dann die Vorlage Konsolenanwendung.

  4. Benennen Sie dem Projekt, und wählen Sie dann auf die Schaltfläche OK.

  5. Visual Studio erstellt das Projekt. Fügen Sie einen Verweis auf die folgenden Assemblys hinzu, und wählen Sie OK.

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

  1. Fügen Sie eine Richtlinie using in der Standard-cs-Datei wie folgt. using Microsoft.SharePoint.Client;

  2. Fügen Sie der Main-Methode in der Datei den folgenden Code.


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. Ersetzen Sie die <Website-URL> und <den gültigen Bing Karten Key> durch gültige Werte.
  2. Legen Sie das Zielframework in den Projekteigenschaften als .NET Framework 4.0, und führen Sie das Beispiel.
  3. Der Schlüssel sollte jetzt auf der Ebene der Webserver festgelegt werden.

Nächste Schritte

Weitere Informationen zum Arbeiten mit Standort- und Karten-Funktionalität in SharePoint, finden Sie in der folgenden: