Utilisation de la cmdlet de couplage Register-SPWorkflowService
Découvrez comment utiliser l’applet de commande Register-SPWorkflowService pour coupler correctement 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 de 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.
Remarque
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 à ordinateur unique où SharePoint et Gestionnaire de flux de travail sont colocalisés sur la zone serveur.
Batterie de serveurs à trois ordinateurs où SharePoint et Gestionnaire de flux de travail sont colocalisés 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.
Batterie de serveurs SharePoint à trois ordinateurs jumelée à une batterie de serveurs Gestionnaire de flux de travail non colocalisé.
Notez également que Register-SPWorkflowService utilise les informations d'identification de l'utilisateur actuel.
Conception de l'applet de commande
| Detail | 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. |
| Syntaxe |
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 (obligatoire) |
String |
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 |
Applique la création d’étendue à l’aide du paramètre ScopeName ou met à jour une étendue existante correspondant au même 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