Pacote de integração para SharePoint

Artigo
03/20/2025

Os pacotes de integração são complementos para o System Center - Orchestrator. Eles ajudam você a otimizar as operações de TI em ambientes heterogêneos. Usando pacotes de integração, você pode criar runbooks no Orchestrator que usam atividades executadas por outros componentes do System Center, outros produtos da Microsoft e produtos que não são da Microsoft.

Saiba mais sobre a privacidade do Orchestrator.

Este artigo fornece informações sobre o pacote de integração do System Center para Microsoft SharePoint.

O System Center Integration Pack para Microsoft SharePoint permite a automação de tarefas comuns no SharePoint. Por exemplo, para criar itens de lista, carregar e baixar documentos e monitorar uma lista em busca de alterações.

Observação

Azure Active Directory ou Azure AD ou AAD mencionado em pacotes de integração refere-se ao Microsoft Entra ID. Saiba mais.

Requisitos do sistema

O pacote de integração para SharePoint requer que o software a seguir seja instalado e configurado antes de implementar a integração.

System Center - Orquestrador
Microsoft .NET Framework 4
Microsoft SharePoint

System Center - Orquestrador 2019
Microsoft .NET Framework 4.6.1 ou superior (mais recente .NET Framework recomendado)

Importante

O SharePoint Integration Pack (v10.19.38.0 ou superior) destina-se ao .NET Framework 4.6.1. Verifique se o .NET Framework Runtime v4.6.1 ou posterior está instalado nas máquinas Runbook Designer e Runbook Server. Recomendamos instalar a versão mais recente disponível do .NET framework.
Crie os seguintes arquivos com conteúdo (idêntico), conforme mostrado abaixo, para atualizar supportedRuntimeVersion para 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
Índice:
```
<?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 - Orquestrador 2022
Microsoft .NET Framework 4.7 ou superior (mais recente .NET Framework recomendado)

Faça o download do pacote

O Pacote de Integração do SharePoint para o Orchestrator 2022 continua a funcionar com o Orchestrator 2025.

Baixe o Pacote de Integração do SharePoint aqui.

Baixe o pacote para 2022

Registrar e implantar o pacote de integração

Depois de baixar o arquivo do pacote de integração, você deve registrá-lo com o servidor de gerenciamento do Orchestrator e, em seguida, implantá-lo em servidores runbook e Runbook Designers. Saiba mais sobre instalação do pacote.

O Pacote de Integração do SharePoint executa ações em nome de um usuário que pode acessar seu domínio do SharePoint. O IP autentica com o SharePoint como este usuário em dois modos:

Autenticação básica (padrão, suporta o SharePoint Online e o SharePoint local).
Modern Auth (também conhecido como OAuth) usando o Azure AD (aplicável apenas para o SharePoint Online).

Configurar as conexões de pacote para autenticação básica

Uma conexão estabelece um link reutilizável entre o Orchestrator e um site do SharePoint. Você pode criar quantas conexões forem necessárias para especificar links para vários sites. Você também pode criar várias conexões com o mesmo servidor para permitir diferenças nas permissões de segurança para diferentes contas de usuário.

No Orchestrator Runbook Designer, selecione Opções e selecione Microsoft SharePoint.
A caixa de diálogo Microsoft SharePoint é exibida.
Na guia Configurações , selecione Adicionar para iniciar a configuração da conexão. A caixa de diálogo Adicionar configuração é exibida.
Na caixa Nome, insira um nome para a conexão. Esse nome pode ser o nome do site do SharePoint ou um nome descritivo para distinguir o tipo de conexão.
Na caixa Tipo, selecione Configuração do SharePoint.
Na caixa do Site do SharePoint, insira a URL do site do SharePoint com o qual você deseja integrar.
Nas caixas Nome de Usuário e Senha, insira as credenciais que o Orchestrator usará para se conectar ao site do SharePoint.
Na caixa Domínio, digite o nome do domínio para autorizar o acesso.
Na caixa do SharePoint Online, digite Falso caso a instância do SharePoint estiver local.
Defina a caixa Utilizar OAuth como Falso.
Na caixa Intervalo de Monitor Padrão (segundos), insira um valor de tempo limite em segundos ou mantenha o valor padrão.
Na caixa Máximo de Itens Padrão, insira um valor máximo ou mantenha o valor padrão.
Selecione OK.
Adicione conexões adicionais, se aplicável, e selecione Concluir.

Configurar as conexões de pacote para autenticação moderna (SharePoint Online)

Registre um Aplicativo Cliente do AD no Azure Ative Directory (Instância do AD) e configure o IP para usar esse cliente. O IP autentica em seu nome; portanto, suas credenciais são necessárias no painel de configuração de IP.

Observação

Este modo de autenticação é suportado apenas para o SharePoint Online.

Registrar um aplicativo cliente no Azure AD

Para registrar um aplicativo cliente no Azure AD, siga estas etapas:

Vá para o portal do Azure.
Navegue até Azure Active Directory>registo de aplicaçõese selecione Novo registo para registrar.
Defina um nome aplicável para o aplicativo e escolha o URI de redirecionamento (cliente público/aplicativo nativo) indicado no menu suspenso.
Escolha o tipo de conta dependendo da configuração do AD e se você usa produtos locais e online.
Selecione Registo.

Visão geral do aplicativo

Os ApplicationID e TenantID são exibidos em Visão Geral ; anote-os.

Captura de tela de Visão geral.

URI de redirecionamento

Defina o URI de redirecionamento OAuth. Escolha a plataforma Cliente público (aplicativo Mobile/Desktop):

Em Configurações da plataforma, selecione Adicionar uma plataforma.
Selecione https://login.microsoftonline.com/common/oauth2/nativeclient como o URI de redirecionamento e selecione Configurar.
Em Configuração Avançada, configure Permitir fluxos de clientes públicos para Sim e selecione Guardar.

Permissões da API

O SharePoint oferece diferentes escopos/permissões de API.

Siga estas etapas para definir permissões de API:

Em Permissões configuradas, selecione Adicionar uma permissãoe selecione SharePoint.
Conceda a permissão AllSites.Write ou uma superior para o aplicativo e depois selecione Adicionar permissões. AllSites.Write é necessário para que todas as atividades IP do SharePoint funcionem, e você pode escolher um escopo mais restrito dependendo das atividades que seus runbooks usam.

Configurar o IP do SharePoint para autenticação moderna

Use as seguintes etapas para configurar o IP do SharePoint para autenticação OAuth:

No Orchestrator Runbook Designer, selecione Opçõese selecione Microsoft SharePoint.
A caixa de diálogo Microsoft SharePoint é exibida.
Na aba Configurações, selecione Adicionar para iniciar a configuração da conexão. A caixa de diálogo Adicionar configuração é exibida.
Na caixa Nome, insira um nome para a conexão. Esse nome pode ser o nome do site do SharePoint ou um nome descritivo para distinguir o tipo de conexão.
Na caixa Tipo, selecione Configuração do SharePoint.
Na caixa do Site do SharePoint, insira a URL do site do SharePoint com o qual você deseja integrar.
Nas caixas Nome de Usuário e Senha, insira as credenciais (de usuário) que o Orchestrator usará para se conectar ao site do SharePoint quando os runbooks forem executados.
Na caixa Domínio, digite o nome do domínio para autorizar o acesso.
Na caixa SharePoint Online, digite True.
Defina a caixa Utilize OAuth como True.
Defina o ID do aplicativo para o ID visto no portal.
Defina o ID de diretório para o ID de diretório (locatário) que aparece no portal. Isso também é conhecido como Microsoft 365 Tenant ID.
Defina o URI da instância do AAD para a sua URL do AD (ou deixe-o com o valor padrão).
Selecione OK.
Adicione conexões adicionais, se aplicável, e selecione Concluir.

Obter dados do SharePoint

Depois de executar as etapas acima, crie um novo runbook e use a atividade Obter itens de lista SharePoint. Quando você define a configuração desejada nas configurações da atividade, o Runbook Designer exercerá suas opções de conexão para buscar alguns dados do SharePoint.

Um pop-up aparece caso haja algum problema com as credenciais ou outras configurações.

Partilhar via