Pacchetto di integrazione per SharePoint

2024-11-19

I Integration Pack sono componenti aggiuntivi per System Center - Orchestrator. Consentono di ottimizzare le operazioni IT in ambienti eterogenei. Usando i Integration Pack, è possibile progettare runbook in Orchestrator che usano attività eseguite da altri componenti di System Center, altri prodotti Microsoft e prodotti non Microsoft.

Altre informazioni sulla privacy di Orchestrator.

Questo articolo fornisce informazioni sul System Center Integration Pack per Microsoft SharePoint.

System Center Integration Pack per Microsoft SharePoint consente l'automazione di attività comuni in SharePoint. Ad esempio, per creare voci di elenco, caricare e scaricare documenti e monitorare un elenco per le modifiche.

Nota

Azure Active Directory o Azure AD o AAD menzionato in Integration Pack fa riferimento all'ID Microsoft Entra. Altre informazioni.

Requisiti di sistema

Integration Pack per SharePoint richiede l'installazione e la configurazione del seguente software per implementare l'integrazione.

System Center - Orchestrator
Microsoft .NET Framework 4
Microsoft SharePoint

System Center - Orchestrator 2019
Microsoft .NET Framework 4.6.1 o versione successiva (versione più recente consigliata di .NET Framework)

Importante

SharePoint Integration Pack (v10.19.38.0 o versione successiva) è destinato a .NET Framework 4.6.1. Assicurarsi che sui computer con Runbook Designer e Runbook Server sia installato il Runtime del .NET Framework v4.6.1 o versione successiva. È consigliabile installare la versione più recente di .NET Framework disponibile.
Creare i file seguenti con il contenuto (identico), come illustrato di seguito per eseguire l'aggiornamento supportedRuntimeVersion alla versione 4:
- %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
Contenuti:
```
<?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 o versione successiva (versione più recente consigliata di .NET Framework)

Scaricare il pacchetto

SharePoint Integration Pack per Orchestrator 2022 continua a funzionare con Orchestrator 2025.

Scaricare il Pacchetto di integrazione SharePoint qui.

Scaricare il pacchetto per 2022

Registrare e distribuire il Integration Pack

Dopo aver scaricato il file del Pacchetto di integrazione, è necessario registrarlo con il server di gestione di Orchestrator e quindi distribuirlo nei server runbook e nelle finestre di progettazione runbook. Informazioni sull'installazione del pacchetto.

SharePoint Integration Pack esegue azioni per conto di un utente che può accedere al dominio di SharePoint. L'IP esegue l'autenticazione con SharePoint come utente in due modalità:

Autenticazione di base (impostazione predefinita, supporta sia SharePoint Online che SharePoint locale).
Autenticazione moderna (nota anche come OAuth) con Azure AD (applicabile solo per SharePoint Online).

Configurare le connessioni al pacchetto per l'autenticazione di base

Una connessione stabilisce un collegamento riutilizzabile tra Orchestrator e un sito di SharePoint. È possibile creare un numero illimitato di connessioni necessarie per specificare collegamenti a diversi siti. È possibile anche creare più connessioni verso lo stesso server in modo da differenziare le autorizzazioni di protezione dei diversi account utente.

In Orchestrator Runbook Designer selezionare Opzioni e selezionare Microsoft SharePoint.
Verrà visualizzata la finestra di dialogo Microsoft SharePoint .
Nella scheda Configurazioni selezionare Aggiungi per avviare l'installazione della connessione. Verrà visualizzata la finestra di dialogo Aggiungi configurazione .
Nella casella Nome immettere un nome per la connessione. Questo nome può essere il nome del sito di SharePoint o un nome descrittivo per distinguere il tipo di connessione.
Nella casella Tipo selezionare Configurazione di SharePoint.
Nella casella Sito di SharePoint immettere l'URL del sito di SharePoint con cui si vuole eseguire l'integrazione.
Nelle caselle Nome utente e Password immettere le credenziali usate da Orchestrator per connettersi al sito di SharePoint.
Nella casella Dominio immettere il nome del dominio per autorizzare l'accesso.
Nella casella SharePoint Online immettere False se l'istanza di SharePoint è locale.
Impostare la casella Utilizza OAuth su Falso.
Nella casella Intervallo monitoraggio predefinito (secondi) immettere un valore di timeout in secondi o mantenere il valore predefinito.
Nella casella Numero massimo predefinito di elementi immettere un valore massimo o mantenere il valore predefinito.
Seleziona OK.
Aggiungere altre connessioni, se applicabile, e selezionare Fine.

Configurare le connessioni al pacchetto per l'autenticazione moderna (SharePoint Online)

Registrare un'applicazione client di Active Directory in Azure Active Directory (istanza di AD) e configurare l'indirizzo IP per l'uso di questo client. L'IP esegue l'autenticazione per conto dell'utente; di conseguenza, le credenziali sono necessarie nel riquadro di configurazione IP.

Nota

Questa modalità di autenticazione è supportata solo per SharePoint Online.

Registrare un'applicazione client in Azure AD

Per registrare un'applicazione client in Azure AD, seguire questa procedura:

Vai al portale di Azure.
Passare ad Azure Active Directory> Registrazioni app e selezionare Nuova registrazione per la registrazione.
Impostare un nome applicabile per l'applicazione e scegliere l'URI di reindirizzamento indicato (client pubblico/app nativa) dal menu a discesa.
Scegliere il tipo di account a seconda della configurazione di AD e se si usano prodotti sia locali che online.
Selezionare Registra.

Panoramica dell'app

L'ApplicationID e il TenantID vengono visualizzati in Panoramica; li annoti.

Screenshot della panoramica.

URI di reindirizzamento

Impostare l'URI di reindirizzamento OAuth. Scegliere la piattaforma Client pubblico (app per dispositivi mobili/desktop) :

In Configurazioni della piattaforma selezionare Aggiungi una piattaforma.

Screenshot di Aggiungi piattaforma.
Selezionare https://login.microsoftonline.com/common/oauth2/nativeclient come URI di reindirizzamento e selezionare Configura.
In Impostazione avanzata impostare Consenti flussi client pubblici su Sì e selezionare Salva.

Autorizzazioni delle API

SharePoint offre diversi ambiti/autorizzazioni per le API.

Seguire questa procedura per impostare le autorizzazioni dell'API:

In Autorizzazioni configurate selezionare Aggiungi un'autorizzazione e selezionare SharePoint.
Concedere l'autorizzazione AllSites.Write o superiore all'app e quindi selezionare Aggiungi autorizzazioni. AllSites.Write è necessario per il funzionamento di tutte le attività IP di SharePoint ed è possibile scegliere un ambito più ristretto a seconda delle attività usate dai runbook.

Configurare l'IP di SharePoint per l'autenticazione moderna

Seguire questa procedura per configurare l'indirizzo IP di SharePoint per l'autenticazione OAuth:

In Orchestrator Runbook Designer selezionare Opzioni e selezionare Microsoft SharePoint.
Verrà visualizzata la finestra di dialogo Microsoft SharePoint .
Nella scheda Configurazioni selezionare Aggiungi per avviare l'installazione della connessione. Verrà visualizzata la finestra di dialogo Aggiungi configurazione .
Nella casella Nome immettere un nome per la connessione. Questo nome può essere il nome del sito di SharePoint o un nome descrittivo per distinguere il tipo di connessione.
Nella casella Tipo selezionare Configurazione di SharePoint.
Nella casella Sito di SharePoint immettere l'URL del sito di SharePoint con cui si vuole eseguire l'integrazione.
Nelle caselle Nome utente e Password immettere le credenziali (utente) usate da Orchestrator per connettersi al sito di SharePoint quando vengono eseguiti i runbook.
Nella casella Dominio immettere il nome del dominio per autorizzare l'accesso.
Nella casella SharePoint Online immettere True.
Impostare la casella Utilizza OAuth su Vero.
Impostare l'ID dell'applicazione sull'ID dell'applicazione visualizzato nel portale.
Impostare l'ID directory all'ID del tenant (directory) visualizzato nel portale. Questa operazione è nota anche come ID tenant di Microsoft 365.
Impostare l'URI dell'istanza di AAD sull'URL di Active Directory o lasciare impostato il valore predefinito.
Seleziona OK.
Aggiungere altre connessioni, se applicabile, e selezionare Fine.

Ottenere dati da SharePoint

Dopo aver eseguito i passaggi precedenti, creare un nuovo runbook e usare l'attività di SharePoint Ottieni elementi elenco. Quando si imposta la configurazione desiderata nelle impostazioni dell'attività, Runbook Designer userà le opzioni di connessione per recuperare alcuni dati da SharePoint.

In caso di problemi con le credenziali o altre impostazioni, verrà visualizzato un popup.