Integrationspaket für SharePoint

Wichtig

Diese Version von Orchestrator hat das Ende des Support erreicht. Es wird empfohlen, ein Upgrade auf Orchestrator 2019 zu durchführen.

Integrationspakete sind Add-Ons für System Center Orchestrator. Sie helfen Ihnen, den IT-Betrieb in heterogenen Umgebungen zu optimieren. Mithilfe von Integrationspaketen können Sie Runbooks in Orchestrator entwerfen, die Aktivitäten verwenden, die von anderen System Center-Komponenten, anderen Microsoft-Produkten und von Nicht-Microsoft-Produkten ausgeführt werden.

Erfahren Sie mehr über den Datenschutz für Orchestrator.

Dieser Artikel enthält Informationen zum System Center Integrationspaket für Microsoft SharePoint.

Das System Center Integration Pack für Microsoft SharePoint ermöglicht die Automatisierung gängiger Aufgaben in SharePoint. Beispielsweise zum Erstellen von Listenelementen, zum Hochladen und Herunterladen von Dokumenten und zum Überwachen einer Liste auf Änderungen.

Systemanforderungen

Das Integrationspaket für SharePoint erfordert, dass die folgende Software installiert und konfiguriert wird, bevor Sie die Integration implementieren.

  • System Center-Orchestrator
  • Microsoft .NET Framework 4
  • Microsoft SharePoint

Herunterladen des Pakets

Registrieren und Bereitstellen des Integrationspakets

Nachdem Sie die Integrationspaketdatei heruntergeladen haben, müssen Sie sie beim Orchestrator-Verwaltungsserver registrieren und dann auf Runbookservern und Runbook Designern bereitstellen. Erfahren Sie mehr über die Installation des Pakets.

Das SharePoint Integration Pack führt Aktionen im Namen eines Benutzers aus, der auf Ihre SharePoint kann. Die IP-Adresse wird mit SharePoint als dieser Benutzer in zwei Modi authentifiziert:

  • Standardauthentifizierung (Standardmäßig unterstützt sowohl SharePoint Online als auch SharePoint OnPrem).
  • Moderne Authentifizierung (auch als OAuth bekannt) mit Azure AD (gilt nur für SharePoint Online).

Konfigurieren der Paketverbindungen für die Standardauthentifizierung

Eine Verbindung stellt eine wiederverwendbare Verbindung zwischen Orchestrator und einem SharePoint fest. Sie können so viele Verbindungen erstellen, wie Sie benötigen, um Links zu mehreren Standorten anzugeben. Sie haben auch die Möglichkeit, mehrere Verbindungen zu dem gleichen Server zu erstellen, wenn Sie unterschiedliche Sicherheitsberechtigungen für verschiedene Benutzerkonten berücksichtigen möchten.

  1. Klicken Sie im Runbook Designer Orchestratorauf Optionenund dann auf Microsoft SharePoint.
  2. Das Dialogfeld Microsoft SharePoint wird angezeigt.
  3. Klicken Sie auf der Registerkarte Konfigurationen auf Hinzufügen, um mit dem Einrichten der Verbindung zu beginnen. Das Dialogfeld Konfiguration hinzufügen wird angezeigt.
  4. Geben Sie im Feld Name einen Namen für die Verbindung ein. Dieser Name kann der Name des SharePoint Standorts oder ein beschreibender Name sein, um den Verbindungstyp zu unterscheiden.
  5. Wählen Sie im Feld Typ die Option SharePoint Aus.
  6. Geben Sie SharePoint Feld Website die URL der SharePoint Website ein, in die Sie integrieren möchten.
  7. Geben Sie in die Felder Benutzername und Kennwort die Anmeldeinformationen ein, die Orchestrator zum Herstellen einer Verbindung mit der SharePoint verwendet.
  8. Geben Sie im Feld Domäne den Namen der Domäne ein, um den Zugriff zu autorisieren.
  9. Geben Sie im SharePoint Onlinefalseein, wenn die SharePoint OnPrem ist.
  10. Legen Sie das Feld OAuth verwenden auf False fest.
  11. Geben Sie im Feld Standardüberwachungsintervall (Sekunden) einen Time out-Wert in Sekunden ein, oder behalten Sie den Standardwert bei.
  12. Geben Sie im Feld Maximale Standardelemente einen Höchstwert ein, oder behalten Sie den Standardwert bei.
  13. Klicken Sie auf OK.
  14. Fügen Sie ggf. zusätzliche Verbindungen hinzu, und klicken Sie dann auf Fertig stellen.

Konfigurieren der Paketverbindungen für moderne Authentifizierung (SharePoint Online)

Registrieren Sie eine AD-Clientanwendung auf Azure Active Directory (AD-Instanz), und konfigurieren Sie die IP-Adresse für die Verwendung dieses Clients. Die IP-Adresse wird in Ihrem Namen authentifiziert, daher sind Ihre Anmeldeinformationen im IP-Konfigurationsbereich erforderlich.

Beachten Sie, dass dieser Authentifizierungsmodus nur für SharePoint Online unterstützt wird.

Registrieren einer Clientanwendung auf Azure AD

Führen Sie die folgenden Schritte aus, Azure AD client application on Azure AD registrieren:

  1. Navigieren Sie zum Azure-Portal.

  2. Navigieren Sie zu Azure Active DirectoryApp-Registrierungen, und klicken Sie auf Neue Registrierung, um sich zu registrieren.

  3. Legen Sie einen anwendbaren Namen für die Anwendung fest, und wählen Sie im Dropdownmenü den angegebenen Umleitungs-URI (Öffentlicher Client/native App) aus.

    Registration

  4. Wählen Sie den Kontotyp abhängig von Ihrem AD-Setup und der Verwendung von on-prem- und online-Produkten aus.

  5. Klicken Sie auf Registrieren.

App-Übersicht

ApplicationID undTenantID werden unter Übersicht angezeigt.Notieren Sie sich diese.

Overview

Umleitungs-URI

Legen Sie den OAuth-Umleitungs-URI fest. Wählen Sie die Plattform Öffentlicher Client (Mobile/Desktop-App) aus:

  1. Klicken Sie unter Plattformkonfigurationenauf Plattform hinzufügen.

    Add platform

  2. Wählen Sie https://login.microsoftonline.com/common/oauth2/nativeclient als Umleitungs-URI aus, und klicken Sie https://login.microsoftonline.com/common/oauth2/nativeclient

    Redirect URI

  3. Legen Sie unter Erweiterte Einstellungdie Einstellung Öffentliche Clientflüsse zulassen auf Ja fest,und klicken Sie dann auf Speichern.

    Client flows

API-Berechtigungen

SharePoint bietet verschiedene API-Bereiche/-Berechtigungen.

Führen Sie die folgenden Schritte aus, um API-Berechtigungen zu festlegen:

  1. Klicken Sie unter KonfigurierteBerechtigungen auf Berechtigung hinzufügen,und wählen Sie dann SharePoint.

    SharePoint API

  2. Erteilen Sie der App die Berechtigung AllSites.Write oder höher, und wählen Sie dann Berechtigungen hinzufügen aus. AllSites.Write ist erforderlich, damit alle SharePoint-IP-Aktivitäten funktionieren, und Sie können je nach den Aktivitäten, die Ihre Runbooks verwenden, einen engeren Bereich auswählen.

    SharePoint API Scopes

Konfigurieren der SharePoint-IP für die moderne Authentifizierung

Führen Sie die folgenden Schritte aus, um die ip SharePoint für die OAuth-Authentifizierung zu konfigurieren:

  1. Klicken Sie im Runbook Designer Orchestratorauf Optionenund dann auf Microsoft SharePoint.

  2. Das Dialogfeld Microsoft SharePoint wird angezeigt.

  3. Klicken Sie auf der Registerkarte Konfigurationen auf Hinzufügen, um mit dem Einrichten der Verbindung zu beginnen. Das Dialogfeld Konfiguration hinzufügen wird angezeigt.

  4. Geben Sie im Feld Name einen Namen für die Verbindung ein. Dieser Name kann der Name des SharePoint Standorts oder ein beschreibender Name sein, um den Verbindungstyp zu unterscheiden.

  5. Wählen Sie im Feld Typ die Option SharePoint Aus.

  6. Geben Sie SharePoint Feld Website die URL der SharePoint Website ein, in die Sie integrieren möchten.

  7. Geben Sie in die Felder Benutzername und Kennwort die (Benutzer-)Anmeldeinformationen ein, die Orchestrator zum Herstellen einer Verbindung mit der SharePoint-Website verwendet, wenn Runbooks ausgeführt werden.

  8. Geben Sie im Feld Domäneden Namen der Domäne ein, um den Zugriff zu autorisieren.

  9. Geben Sie im SharePoint Online true ein.

  10. Legen Sie das Feld OAuth nutzen auf True fest.

  11. Legen Sie die Anwendungs-ID auf die Anwendungs-ID fest, die im Portal angezeigt wird.

  12. Legen Sie die Verzeichnis-ID auf die Verzeichnis-ID (Mandant) fest, die im Portal angezeigt wird. Dies wird auch als Microsot365-Mandanten-ID bezeichnet.

  13. Legen Sie AAD Instanz-URI auf Ihre AD-URL fest (oder lassen Sie den Standardwert erhalten).

  14. Klicken Sie auf OK.

  15. Fügen Sie ggf. zusätzliche Verbindungen hinzu, und klicken Sie dann auf Fertig stellen.

Daten aus SharePoint

Nachdem Sie die oben genannten Schritte ausgeführt haben, erstellen Sie ein neues Runbook, und verwenden Sie die Aktivität Get List Items SharePoint. Wenn Sie die gewünschte Konfiguration in den Einstellungen der Aktivität festlegen, Runbook Designer die Verbindungsoptionen zum Abrufen einiger Daten aus SharePoint.

Für den Fall, dass ein Problem mit den Anmeldeinformationen oder anderen Einstellungen vor liegt, wird ein Popupfenster angezeigt.