Utilisation de la cmdlet de couplage Register-SPWorkflowService

Découvrez comment utiliser l’cmdlet Register-SPWorkflowService pour jumeler SharePoint avec Gestionnaire de flux de travail. L’installation et la configuration de Microsoft SharePoint pour prendre en charge le développement de flux de travail nécessitent le « jumelage » de vos installations de SharePoint et Gestionnaire de flux de travail. Dans la plupart des scénarios, cette association est facilement effectuée à l'aide de l' applet de commande Register-SPWorkflowService, qui est fourni avec votre installation de SharePoint.

Notes

Les flux de travail SharePoint 2010 ont été retirés depuis le 1er août 2020 pour les nouveaux locataires et retirés des locataires existants le 1er novembre 2020. Si vous utilisez des flux de travail SharePoint 2010, nous vous recommandons de migrer vers Power Automate ou d'autres solutions prises en charge. Pour plus d'informations, voir la retraite du flux de travail SharePoint 2010.

En premier lieu, cette applet de commande n'est pas utile pour chaque scénario de couplage. Register-SPWorkflowService est utile uniquement dans les scénarios de couplage suivants :

  • Batterie de serveurs à un ordinateur SharePoint et Gestionnaire de flux de travail sont co-situées sur la zone de serveur.

  • Batterie de serveurs à trois ordinateurs SharePoint et Gestionnaire de flux de travail sont co-situées sur les trois ordinateurs. (Ajouter qu'un ordinateur quatrième est recherche doit se trouver sur un ordinateur distinct et Workflow Manager haute disponibilité est requise. Si ce dernier est requis, il doit être installé sur tous les trois ordinateurs.

  • Une batterie de serveurs SharePoint à trois ordinateurs couplée à une batterie de serveurs Gestionnaire de flux de travail co-située.

Notez également que Register-SPWorkflowService utilise les informations d'identification de l'utilisateur actuel.

Conception de l'applet de commande

Détail Description
Verbe
Inscrire
Nom
SPWorkflowService
Description
Vous pouvez coupler une batterie de serveurs sps15short avec une batterie de serveurs Workflow Manager. Vous devez exécuter cette applet de commande qu'une seule fois par batterie de serveurs. Avant d'exécuter l'applet de commande, vous devez installer le certificat d'autorité de certification racine dans le magasin de certificats d'ordinateur et le magasin de certificats de SharePoint. Pour ce faire, utilisez l' applet de commande New-SPTrustedRootAuthority. (Consultez les instructions ci-dessous).
Type de sortie
Aucun.
La syntaxe que vous choisissez dans le tableau de syntaxe des propriétés à valeurs multiples est précisée sous la forme d'une valeur de paramètre dans une cmdlet. Par exemple, la commande suivante ajoute plusieurs valeurs à une propriété à valeurs multiples :
Register-SPWorkflowService -SPSite <URI or GUID representing an SPSite object> -WorkflowHostUri <workflow service endpoint URL> -ScopeName <string> [-PartitionMode] [-AllowOAuthHttp] [-Force]

Paramètres de l’applet de commande

Paramètre Type Description
SPSite (obligatoire)
SPSitePipeBind
L'URL d'une collection de sites de longue durée sur la batterie de serveurs SharePoint Server qui sert de point de terminaison du jumelage. Informations pour le jumelage sont déduites à partir de cette URL.
WorkflowHostUri (Required)
Chaîne
L'URL du point de terminaison Workflow Manager pour le jumelage. Fournit à l'hôte de flux de travail URI en même temps que le numéro de port.
ScopeName
Chaîne
Le nom à utiliser pour identifier la batterie couplé SharePoint Server par le service de flux de travail. La valeur par défaut est « SharePoint ». Vous devez spécifier ce paramètre si vous tentez de couplage de plusieurs batteries de serveurs SharePoint vers une batterie de serveurs Workflow Manager uniquement.
PartitionMode
SwitchParameter
Utilisez ce paramètre uniquement pour la batterie de serveurs SharePoint mutualisé. Le mode de partition est spécifié par le service SharePoint. Notez que vous pouvez créer l'architecture mutualisée dans une batterie de serveurs SharePoint après l'exécution de cette applet de commande ; Par conséquent, l'applet de commande ne peut pas déduire cette valeur de paramètre implicitement à partir de l'état existant de la batterie de serveurs SharePoint.
AllowOAuthHttp
SwitchParameter
Permet d'exchange OAuth et des métadonnées sur HTTP. Cette option est utile dans les tests, mais pas dans le mode de production. Utilisez cette option uniquement lorsque SharePoint est configuré pour prendre en charge HTTP. Il n'est pas nécessaire que le Workflow Manager être configuré pour utiliser le protocole HTTP.
Force
SwitchParameter
Enforces the creating of scope using ScopeName parameter, or updates an existing scope corresponding to the same ScopeName. If not specified and scope with the same name exists, the cmdlet will throw an error.

Exemple


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

Voir aussi