Integratiepakket voor SharePoint
Belangrijk
Deze versie van Orchestrator heeft het einde van de ondersteuning bereikt. U wordt aangeraden een upgrade uit te voeren naar Orchestrator 2022.
Integratiepakketten zijn invoegtoepassingen voor System Center - Orchestrator. Ze helpen u bij het optimaliseren van de IT-activiteiten in heterogene omgevingen. Met behulp van integratiepakketten kunt u runbooks ontwerpen in Orchestrator die gebruikmaken van activiteiten die worden uitgevoerd door andere System Center-onderdelen, andere Microsoft-producten en niet-Microsoft-producten.
Meer informatie over Orchestrator-privacy.
Dit artikel bevat informatie over het System Center-integratiepakket voor Microsoft SharePoint.
Met het System Center Integration Pack voor Microsoft SharePoint kunt u algemene taken in SharePoint automatiseren. Bijvoorbeeld om lijstitems te maken, documenten te uploaden en te downloaden en een lijst te controleren op wijzigingen.
Systeemvereisten
Voordat u deze integratie implementeert, wordt volgens het SharePoint-integratiepakket vereist dat de volgende software wordt geïnstalleerd en geconfigureerd.
- System Center: Orchestrator
- Microsoft .NET Framework 4
- Microsoft SharePoint
- System Center - Orchestrator 2019
- Microsoft .NET Framework 4.6.1 of hoger (meest recente .NET Framework aanbevolen)
Belangrijk
SharePoint Integration Pack (v10.19.38.0 of hoger) doelen .NET Framework 4.6.1. Zorg ervoor dat .NET Framework Runtime v4.6.1 of hoger is geïnstalleerd op Runbook Designer- en Runbook Server-computers. U wordt aangeraden de nieuwste beschikbare versie van .NET Framework te installeren.
Maak de volgende bestanden met (identieke) inhoud zoals hieronder wordt weergegeven om bij te werken
supportedRuntimeVersion
naar v4:%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
Inhoud:
<?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 of hoger (meest recente .NET Framework aanbevolen)
Het pakket downloaden
Het integratiepakket registreren en implementeren
Nadat u het integratiepakketbestand hebt gedownload, moet u het registreren bij de Orchestrator-beheerserver en het vervolgens implementeren op runbookservers en Runbook Designers. Meer informatie over het installeren van het pakket.
Het SharePoint-integratiepakket voert acties uit namens een gebruiker die toegang heeft tot uw SharePoint-domein. Het IP-adres wordt in twee modi met SharePoint geverifieerd als deze gebruiker:
- Basisverificatie (standaard, ondersteunt zowel SharePoint Online als SharePoint on-premises).
- Moderne verificatie (ook wel OAuth genoemd) met behulp van Azure AD (alleen van toepassing voor SharePoint Online).
De pakketverbindingen configureren voor de basisverificatie
Een verbinding brengt een herbruikbare koppeling tussen Orchestrator en een SharePoint-site tot stand. U kunt zoveel verbindingen maken als u nodig hebt om koppelingen naar meerdere sites op te geven. U kunt ook meerdere verbindingen met diezelfde server maken om verschillen in beveiligingsmachtigingen voor verschillende gebruikersaccounts mogelijk te maken.
- Selecteer opties in de Designer Orchestrator Runbook en selecteer Microsoft SharePoint.
- Het dialoogvenster Microsoft SharePoint wordt weergegeven.
- Selecteer op het tabblad Configuratiesde optie Toevoegen om de installatie van de verbinding te starten. Het dialoogvenster Configuratie toevoegen wordt weergegeven.
- Voer in het vak Naam een naam voor de verbinding in. Deze naam kan de naam zijn van de SharePoint-site of een beschrijvende naam om het type verbinding te onderscheiden.
- Selecteer SharePoint-configuratie in het vak Type.
- Voer in het vak SharePoint-site de URL in van de SharePoint-site waarmee u wilt integreren.
- Voer in de vakken Gebruikersnaam en Wachtwoord de referenties in die Orchestrator gebruikt om verbinding te maken met de SharePoint-site.
- Voer in het vak Domeinde naam van het domein in waarmee toegang moet worden goedgekeurd.
- Voer onwaar in het vak SharePoint Online in als het SharePoint-exemplaar on-premises is.
- Stel het vak OAuth gebruiken in op Onwaar.
- Voer in het vak Standaardmonitorinterval (seconden) een time-outwaarde in seconden in of behoud de standaardwaarde.
- Voer in het vak Standaardmaximumitems een maximumwaarde in of behoud de standaardwaarde.
- Selecteer OK.
- Voeg, indien van toepassing, extra verbindingen toe en selecteer Voltooien.
De pakketverbindingen configureren voor moderne verificatie (SharePoint Online)
Registreer een AD-clienttoepassing in uw Azure Active Directory (AD-exemplaar) en configureer het IP-adres voor het gebruik van deze client. Het IP-adres wordt namens u geverifieerd; Daarom zijn uw referenties vereist in het deelvenster IP-configuratie.
Notitie
Deze verificatiemodus wordt alleen ondersteund voor SharePoint Online.
Een clienttoepassing registreren voor Azure AD
Voer de volgende stappen uit als u een clienttoepassing wilt registreren voor Azure AD:
Ga naar de Azure Portal.
Navigeer naar Azure Active Directory>App-registraties en selecteer Nieuwe registratie om u te registreren.
Stel een toepasselijke naam in voor de toepassing en kies de aangegeven omleidings-URI (openbare client/systeemeigen app) in de vervolgkeuzelijst.
Kies het accounttype, afhankelijk van uw AD-installatie en of u zowel on-premises als onlineproducten gebruikt.
Selecteer Registreren.
Overzicht van apps
De ApplicationID en TenantID worden weergegeven onder Overzicht; noteer ze.
Omleidings-URI
Stel de OAuth-omleidings-URI in. Kies het platform voor de openbare client (mobiele/bureaublad-app) :
Selecteer onder Platformconfiguratiesde optie Een platform toevoegen.
Selecteer
https://login.microsoftonline.com/common/oauth2/nativeclient
als omleidings-URI en selecteer Configureren.Stel onder Geavanceerde instellingOpenbare clientstromen toestaan in op Ja en selecteer Opslaan.
API-machtigingen
SharePoint biedt verschillende API-bereiken/-machtigingen.
Volg deze stappen om API-machtigingen in te stellen:
Selecteer onder Geconfigureerde machtigingen de optie Een machtiging toevoegen en selecteer SharePoint.
Verleen de machtiging AllSites.Write aan de app of hoger en selecteer Machtigingen toevoegen. AllSites.Write is vereist om alle SharePoint IP-activiteiten te laten werken en u kunt een smaller bereik kiezen, afhankelijk van de activiteiten die uw runbooks gebruiken.
Het SharePoint-IP-adres voor moderne verificatie configureren
Gebruik de volgende stappen om het SharePoint-IP-adres voor OAuth-verificatie te configureren:
Selecteer in de Designer Orchestrator Runbookde optie Opties en selecteer Microsoft SharePoint.
Het dialoogvenster Microsoft SharePoint wordt weergegeven.
Selecteer op het tabblad Configuratiesde optie Toevoegen om de installatie van de verbinding te starten. Het dialoogvenster Configuratie toevoegen wordt weergegeven.
Voer in het vak Naam een naam voor de verbinding in. Deze naam kan de naam zijn van de SharePoint-site of een beschrijvende naam om het type verbinding te onderscheiden.
Selecteer in het vak TypeSharePoint-configuratie.
Voer in het vak SharePoint-site de URL in van de SharePoint-site waarmee u wilt integreren.
Voer in de vakken Gebruikersnaam en Wachtwoord de (gebruikers)referenties in die Orchestrator gebruikt om verbinding te maken met de SharePoint-site als er runbooks worden uitgevoerd.
Voer in het vak Domein de naam in van het domein om toegang te verlenen.
Voer in het vak SharePoint OnlineWaar in.
Stel het vak OAuth gebruiken in op Waar.
Stel Toepassings-id in op de toepassings-id die wordt weergegeven in de portal.
Stel Map-id in op de map-id (tenant) die in de portal wordt weergegeven. Dit wordt ook wel Microsoft 365-tenant-id genoemd.
Stel URI van AAD-exemplaar in op uw AD-URL (of laat deze op de standaardwaarde staan).
Selecteer OK.
Voeg, indien van toepassing, extra verbindingen toe en selecteer Voltooien.
Gegevens ophalen uit SharePoint
Nadat u de bovenstaande stappen hebt uitgevoerd, maakt u een nieuw runbook en gebruikt u de SharePoint-activiteit Lijstitems ophalen. Wanneer u de gewenste configuratie instelt in de instellingen van de activiteit, voert Runbook Designer uw verbindingsopties uit om bepaalde gegevens op te halen uit SharePoint.
Er wordt een pop-up weergegeven als er een probleem is met de referenties of andere instellingen.