Utilizar o cmdlet de emparelhamento Register-SPWorkflowService

Saiba como utilizar o cmdlet Register-SPWorkflowService para emparelhar com êxito o SharePoint com Gerenciador de Fluxos de Trabalho. Instalar e configurar o Microsoft SharePoint para suportar o desenvolvimento de fluxos de trabalho requer "emparelhar" as instalações do SharePoint e do Gerenciador de Fluxos de Trabalho. Na maioria dos cenários, esse emparelhamento é feita com facilidade usando o cmdlet Register-SPWorkflowService, que está incluído com a instalação do SharePoint.

Observação

Os fluxos de trabalho do Microsoft Office SharePoint Online 2010 foram desativados desde 1º de agosto de 2020 para novos locatários e removidos de locatários existentes em 1º de novembro de 2020. Se você estiver usando fluxos de trabalho do Microsoft Office SharePoint Online 2010, recomendamos a migração para o Power Automate ou outras soluções suportadas. Para mais informações, confira Retirada do fluxo de trabalho do Microsoft Office SharePoint Online 2010.

É importante, este cmdlet não é útil para todos os cenários de emparelhamento. Register-SPWorkflowService é útil apenas nos seguintes cenários emparelhamento:

  • Farm de servidores de um computador onde o SharePoint e Gerenciador de Fluxos de Trabalho estão colocalizados na caixa do servidor.

  • Farm de servidores de três computadores onde o SharePoint e Gerenciador de Fluxos de Trabalho estão colocalizados nos três computadores. (Adicione que um quarto computador é pesquisa precisa estar em um computador separado e Workflow Manager HA é necessário. Se o último for necessário, ele deve ser instalado em todos os três computadores.

  • Farm do SharePoint de três computadores emparelhado com um farm de servidores Gerenciador de Fluxos de Trabalho não localizado.

Observe também que Register-SPWorkflowService usa as credenciais do usuário atual.

Design de cmdlet

Ver os detalhes Descrição
Verbo
Registro
Substantivo
SPWorkflowService
Descrição
Um farm sps15short com um farm Workflow Manager é emparelhado. Você deve executar este cmdlet uma vez por farm. Antes de executar o cmdlet, você deve instalar o certificado de autoridade de certificação raiz no repositório de certificados de máquina e o repositório de certificados do SharePoint. Para fazer isso, use o cmdlet New-SPTrustedRootAuthority. (Consulte as instruções abaixo).
Tipo de saída
Nenhum.
Sintaxe
Register-SPWorkflowService -SPSite <URI or GUID representing an SPSite object> -WorkflowHostUri <workflow service endpoint URL> -ScopeName <string> [-PartitionMode] [-AllowOAuthHttp] [-Force]

Parâmetros do cmdlet

Parâmetro Tipo Descrição
SPSite (Obrigatório)
SPSitePipeBind
A URL de um conjunto de sites no farm Servidor do SharePoint que serve como ponto de extremidade emparelhamento longa duração. Informações para pareamento é determinada diretamente dessa URL.
WorkflowHostUri (Obrigatório)
Cadeia de caracteres
A URL do ponto de extremidade Workflow Manager para o emparelhamento. Fornece o URI de host de fluxo de trabalho, juntamente com o número da porta.
ScopeName
String
O nome a ser usado pelo serviço de fluxo de trabalho para identificar o farm emparelhados Servidor do SharePoint. O valor padrão é "SharePoint". Você precisa especificar esse parâmetro se tentar emparelhar vários farms do SharePoint para um farm de Workflow Manager.
PartitionMode
Parâmetro
Use este parâmetro somente para o farm do SharePoint de multilocatário. O modo de partição é especificado por um serviço do SharePoint. Observe que você pode criar multilocação em um farm do SharePoint depois que esse cmdlet for executado; Portanto, o cmdlet não é possível deduzir esse valor de parâmetro implicitamente do estado existente do farm do SharePoint.
AllowOAuthHttp
Parâmetro
Habilita o exchange metadados e OAuth sobre HTTP. Isso é útil em testes, mas não no modo de produção. Use esta opção somente quando o SharePoint estiver configurado para suportar HTTP. Não é necessário que os Workflow Manager sejam configurados para usar o HTTP.
Force
Parâmetro
Impõe a criação de âmbito com o parâmetro ScopeName ou atualiza um âmbito existente correspondente ao mesmo ScopeName. Se não especificado e escopo com o mesmo nome existe, o cmdlet irá gerar um erro.

Exemplo


PS> Register-SPWorkflowService -SPSite "https://myserver/mysitecollection" -WorkflowHostUri "http://workflow.example.com:12291" -ScopeName "SharePoint2" -PartitionMode -AllowOAuthHttp  -Force

Confira também