Integrationspaket für SharePoint

Artikel
11/19/2024

Integrationspakete sind Add-Ons für System Center – Orchestrator. Sie helfen Ihnen, die IT-Vorgänge 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 Nicht-Microsoft-Produkten ausgeführt werden.

Weitere Informationen zum Orchestrator-Datenschutz.

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

Das System Center-Integrationspaket für Microsoft SharePoint ermöglicht die Automatisierung allgemeiner Aufgaben in SharePoint. Zum Beispiel zum Erstellen von Listeneinträgen, zum Hoch- und Herunterladen von Dokumenten und zum Überwachen einer Liste auf Änderungen.

Hinweis

Azure Active Directory oder Azure AD oder AAD, die in Integrationspaketen erwähnt werden, beziehen sich auf die Microsoft Entra-ID. Weitere Informationen

Systemanforderungen

Für das Integrationspaket für SharePoint muss folgende Software installiert und konfiguriert sein, bevor Sie die Integration implementieren:

System Center-Orchestrator
Microsoft .NET Framework 4
Microsoft SharePoint

System Center – Orchestrator 2019
Microsoft .NET Framework 4.6.1 oder höher (neuestes .NET Framework empfohlen)

Wichtig

SharePoint-Integrationspaket (v10.19.38.0 oder höher) zielt auf .NET Framework 4.6.1 ab. Stellen Sie sicher, dass .NET Framework Runtime v4.6.1 oder höher auf Runbook Designer- und Runbook-Servercomputern installiert ist. Wir empfehlen, die neueste verfügbare Version des .NET Frameworks zu installieren.
Erstellen Sie die folgenden Dateien mit (identischem) Inhalt wie unten gezeigt, um supportedRuntimeVersion auf v4 zu aktualisieren:
- %systemdrive%/Program Files (x86)/Microsoft System Center/Orchestrator/Runbook Designer/RunbookDesigner.exe.config
- %systemdrive%/Program Files (x86)/Microsoft System Center/Orchestrator/Runbook Designer/RunbookTester.exe.config
- %systemdrive%/Program Files (x86)/Microsoft System Center/Orchestrator/Runbook Server/PolicyModule.exe.config
Inhalt:
```
<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <startup useLegacyV2RuntimeActivationPolicy="true">
    <supportedRuntime version="v4.0.30319"/>
  </startup>
  <system.xml.serialization>
    <xmlSerializer tempFilesLocation="C:\ProgramData\Microsoft System Center 2012\Orchestrator\Activities\XmlSerializers\"/>
  </system.xml.serialization>
</configuration>
```

System Center – Orchestrator 2022
Microsoft .NET Framework 4.7 oder höher (neuestes .NET Framework empfohlen)

Herunterladen des Pakets

SharePoint Integration Pack für Orchestrator 2022 funktioniert weiterhin mit Orchestrator 2025.

Laden Sie das SharePoint-Integrationspaket hier herunter.

Herunterladen des Pakets für 2022

Registrieren und Bereitstellen des Integrationspakets

Nachdem Sie die Datei des Integrationspakets heruntergeladen haben, müssen Sie es auf dem Orchestrator Management Server registrieren und anschließend auf Runbook-Servern und Runbook Designern bereitstellen. Erfahren Sie mehr über die Installation des Pakets.

Das SharePoint-Integrationspaket führt Aktionen im Auftrag eines Benutzers aus, der auf Ihre SharePoint-Domäne zugreifen kann. Die IP authentifiziert sich bei SharePoint als dieser Benutzer in zwei verschiedenen Modi:

Standardauthentifizierung (Standard, unterstützt sowohl SharePoint Online als auch SharePoint lokal).
Moderne Authentifizierung (auch als OAuth bezeichnet) unter Verwendung von Azure AD (gilt nur für SharePoint Online)

Konfigurieren der Paketverbindungen für Basisauthentifizierung

Durch eine Verbindung entsteht eine wiederverwendbare Verknüpfung zwischen Orchestrator und einer SharePoint-Website. Sie können so viele Verbindungen erstellen, wie Sie benötigen, um Links zu mehreren Websites 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.

Wählen Sie im Orchestrator Runbook DesignerOptionen und wählen Sie Microsoft SharePoint.
Das Dialogfeld Microsoft SharePoint erscheint.
Klicken Sie auf der Registerkarte Konfigurationen auf Hinzufügen, um mit dem Einrichten der Verbindung zu beginnen. Das Dialogfeld Konfiguration hinzufügen wird angezeigt.
Geben Sie im Feld Name einen Namen für die Verbindung ein. Dies kann der Name der SharePoint-Website oder ein beschreibender Name zur Unterscheidung des Verbindungstyps sein.
Wählen Sie im Feld Typ die Option SharePoint-Konfiguration aus.
Geben Sie im Feld SharePoint-Website die URL der SharePoint-Website ein, in die Sie integrieren möchten.
Geben Sie in die Felder Benutzername und Kennwort die Anmeldeinformationen von Orchestrator für die Verbindung mit der SharePoint-Website ein.
Geben Sie im Feld Domäne den Namen der Domäne ein, um den Zugriff zu autorisieren.
Geben Sie in das Feld SharePoint OnlineFalse ein, wenn die SharePoint-Instanz vor Ort ist.
Legen Sie das Feld OAuth verwenden auf False fest.
Geben Sie im Feld Standard-Überwachungsintervall (Sekunden) einen Timeout-Wert in Sekunden ein oder behalten Sie den Standardwert bei.
Geben Sie im Feld Standardwert für maximale Elemente einen Höchstwert ein, oder behalten Sie den Standardwert bei.
Wählen Sie OK aus.
Fügen Sie ggf. weitere Verbindungen hinzu und wählen Sie Fertig stellen.

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

Registrieren Sie eine AD-Clientanwendung in Ihrer Azure Active Directory-Instanz (AD-Instanz), und konfigurieren Sie die IP zur Verwendung dieses Clients. Die IP authentifiziert sich in Ihrem Auftrag, daher sind Ihre Anmeldeinformationen im IP-Konfigurationsbereich erforderlich.

Hinweis

Dieser Authentifizierungsmodus wird nur für SharePoint Online unterstützt.

Registrieren einer Clientanwendung bei Azure AD

Führen Sie die folgenden Schritte aus, um eine Clientanwendung in Azure AD zu registrieren:

Öffnen Sie das Azure-Portal.
Navigieren Sie zu Azure Active Directory>App-Registrierungen, und wählen Sie Neue Registrierung, um sich zu registrieren.
Legen Sie einen zutreffenden Namen für die Anwendung fest und wählen Sie die angegebene Redirect URI (Public Client/native App) aus dem Dropdown-Menü.
Wählen Sie den Kontotyp abhängig von Ihrer AD-Einrichtung und davon, ob Sie sowohl On-Premises- als auch Online-Produkte verwenden.
Wählen Sie Registrieren aus.

App-Überblick

Die ApplicationID und TenantID werden unter Übersicht angezeigt; notieren Sie sie.

Screenshot der Übersicht.

Umleitungs-URI

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

Wählen Sie unter Plattformkonfigurationen die Option Plattform hinzufügen aus.
Wählen Sie https://login.microsoftonline.com/common/oauth2/nativeclient als Redirect URI und wählen Sie Konfigurieren.
Legen Sie unter Erweiterte EinstellungÖffentliche Clientflows zulassen auf Ja fest und wählen Sie Speichern.

API-Berechtigungen

SharePoint bietet verschiedene API-Bereiche/-Berechtigungen.

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

Wählen Sie unter Konfigurierte Berechtigungen die Option Berechtigung hinzufügen und wählen Sie SharePoint.
Gewähren 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. Sie können abhängig von den von Ihrem Runbook verwendeten Aktivitäten einen kleineren Bereich wählen.

Konfigurieren der SharePoint-IP für moderne Authentifizierung

Verwenden Sie die folgenden Schritte, um die SharePoint-IP für die OAuth-Authentifizierung zu konfigurieren:

Wählen Sie im Orchestrator Runbook DesignerOptionen und wählen Sie Microsoft SharePoint.
Das Dialogfeld Microsoft SharePoint erscheint.
Klicken Sie auf der Registerkarte Konfigurationen auf Hinzufügen, um mit dem Einrichten der Verbindung zu beginnen. Das Dialogfeld Konfiguration hinzufügen wird angezeigt.
Geben Sie im Feld Name einen Namen für die Verbindung ein. Dies kann der Name der SharePoint-Website oder ein beschreibender Name zur Unterscheidung des Verbindungstyps sein.
Wählen Sie im Feld Typ die Option SharePoint-Konfiguration aus.
Geben Sie im Feld SharePoint-Site die URL der SharePoint-Site ein, mit der Sie integrieren möchten.
Geben Sie in die Felder Benutzername und Kennwort die Anmeldeinformationen (des Benutzers) ein, die Orchestrator für die Verbindung mit der SharePoint-Website bei der Ausführung von Runbooks verwendet.
Geben Sie im Feld Domäne den Namen der Domäne ein, um den Zugriff zu autorisieren.
Geben Sie im Feld SharePoint Online die Option True ein.
Legen Sie das Feld OAuth verwenden auf True fest.
Legen Sie die Anwendungs-ID auf die im Portal angezeigte Anwendungs-ID fest.
Legen Sie die Verzeichnis-ID auf diejenige Verzeichnis-ID (Mandanten-ID) fest, die im Portal angezeigt wird. Diese wird auch als Microsoft 365-Mandanten-ID bezeichnet.
Legen Sie den URI der AAD-Instanz auf Ihre AD-URL fest (oder lassen Sie den Standardwert bestehen).
Wählen Sie OK aus.
Fügen Sie ggf. weitere Verbindungen hinzu und wählen Sie Fertig stellen.

Abrufen von Daten aus SharePoint

Nachdem Sie die obigen Schritte ausgeführt haben, erstellen Sie ein neues Runbook, und verwenden Sie die SharePoint-Aktivität Listenelemente abrufen. Wenn Sie die gewünschte Konfiguration in den Einstellungen der Aktivität festlegen, nutzt Runbook Designer Ihre Verbindungsoptionen, um einige Daten aus SharePoint abzurufen.

Ein Popup wird angezeigt, falls es ein Problem mit den Anmeldeinformationen oder anderen Einstellungen gibt.

Freigeben über