Utilizar o cmdlet de emparelhamento Register-SPWorkflowService
Saiba como usar o cmdlet Register-SPWorkflowService para emparelhar com SharePoint com Gerenciador de Fluxos de Trabalho. Instalar e configurar o Microsoft SharePoint para dar suporte ao desenvolvimento de fluxo de trabalho requer "emparelhamento" de suas instalações de SharePoint e 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 SharePoint 2010 foram desativados desde 1º de agosto de 2020 para novos locatários e desativados 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 obter mais informações, confira Desativação do fluxo de trabalho do SharePoint 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 SharePoint e Gerenciador de Fluxos de Trabalho estão colocalizados na caixa do servidor.
Farm de servidores de três computadores SharePoint e Gerenciador de Fluxos de Trabalho estão colocalizados em todos os 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 de SharePoint de três computadores emparelhado com um farm de servidores Gerenciador de Fluxos de Trabalho não colocalizado.
Observe também que Register-SPWorkflowService usa as credenciais do usuário atual.
Design de cmdlet
| Detalhe | 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. |
| A sintaxe que você escolher da tabela de sintaxe de propriedade de valor múltiplo é especificada como um valor do parâmetro em um cmdlet. Por exemplo, o comando a seguir adiciona vários valores para uma propriedade com valores múltiplos: |
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 SharePoint Server que serve como ponto de extremidade emparelhamento longa duração. Informações para pareamento é determinada diretamente dessa URL. |
| WorkflowHostUri (Required) |
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 SharePoint Server. 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 |
SwitchParameter |
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 |
SwitchParameter |
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 |
SwitchParameter |
Impõe a criação de escopo usando o parâmetro ScopeName ou atualiza um escopo existente correspondente para o 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