ペアリング コマンドレット Register-SPWorkflowService を使用する
コマンドレット Register-SPWorkflowService を使用して、SharePoint とワークフロー マネージャーをペアリングする方法について説明します。 ワークフローの開発をサポートするために Microsoft SharePoint をインストールして構成するには、SharePoint とワークフロー マネージャーの「ペアリング」インストールが必要です。 ほとんどのシナリオでは、このペアリングはコマンドレット Register-SPWorkflowService を使用して簡単に行えますが、これは SharePoint のインストールに含まれています。
注:
SharePoint 2010 ワークフローは、2020 年 8 月 1 日以降、新しいテナント用に廃止され、2020 年 11 月 1 日に既存のテナントから削除されました。 SharePoint 2010 ワークフローを使用している場合は、Power Automate またはその他のサポートされているソリューションに移行することをお勧めします。 詳細については、「SharePoint 2010 ワークフローの廃止」を参照してください。
重要な点は、このコマンドレットが役に立たないペアリング シナリオもあることです。 Register-SPWorkflowService は、次のペアリング シナリオでのみ役に立ちます。
SharePoint とワークフロー マネージャーがサーバー ボックスに併置されている 1 コンピューター サーバー ファーム。
SharePoint とワークフロー マネージャーが 3 つすべてのコンピューターに併置されている 3 コンピューター サーバー ファーム。 (検索を別のコンピューターで行い、ワークフロー マネージャー HA が必要な場合には 4 つ目のコンピューターを追加します。) Workflow Manager HA が必要な場合は、3 つのコンピューターすべてにインストールする必要があります。
併置されていないワークフロー マネージャー サーバー ファームとペアリングされた 3 コンピューター SharePoint ファーム。
また、Register-SPWorkflowService は現在のユーザーの資格情報を使用することに注意してください。
コマンドレット設計
| 詳細 | 説明 |
|---|---|
| 動詞 |
登録 |
| 名詞 |
SPWorkflowService |
| 説明 |
sps15short ファームとワークフロー マネージャー ファームをペアにします。 このコマンドレットは、ファームごとに 1 回実行する必要があります。 コマンドレットを実行する前に、コンピューター証明書ストアと SharePoint 証明書ストアにルート CA 証明書をインストールする必要があります。 これを行うには、 New-SPTrustedRootAuthority コマンドレットを使用します。 (以下の手順を参照してください)。 |
| 出力の型 |
なし。 |
| 構文 |
Register-SPWorkflowService -SPSite <URI or GUID representing an SPSite object> -WorkflowHostUri <workflow service endpoint URL> -ScopeName <string> [-PartitionMode] [-AllowOAuthHttp] [-Force] |
コマンドレットのパラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| SPSite (必須) |
SPSitePipeBind |
ペアリング エンドポイントとして機能する SharePoint Server ファームの長期使用できるサイト コレクションの URL。 ペアリングの情報は、この URL から推定されます。 |
| WorkflowHostUri (必須) |
文字列 |
ペアリング用の ワークフロー マネージャー エンドポイントの URL。 ワークフロー ホスト URI と共にポート番号を指定します。 |
| ScopeName |
String |
ペアリングされた SharePoint Server ファームを識別するためにワークフロー サービスが使用する名前。 既定値は "SharePoint" です。 複数の SharePoint ファームを ワークフロー マネージャー ファームにペアリングする場合にのみ、このパラメーターを指定する必要があります。 |
| PartitionMode |
SwitchParameter |
このパラメーターは、マルチテナント SharePoint ファームに対してのみ使用します。 パーティション モードは SharePoint サービスごとに指定されます。 このコマンドレットを実行した後、SharePoint ファームでマルチテナントを作成できることに注意してください。そのため、コマンドレットは SharePoint ファームの既存の状態からこのパラメーター値を暗黙的に推測することはできません。 |
| AllowOAuthHttp |
SwitchParameter |
HTTP での OAuth とメタデータの交換を有効にします。 これはテストでは役立ちますが、運用モードでは役立ちません。 HTTP をサポートするように SharePoint を構成する場合にのみ、使用してください。 HTTP を使用するにように ワークフロー マネージャー を構成する必要はありません。 |
| Force |
SwitchParameter |
ScopeName パラメーターを使用してスコープの作成を強制するか、同じ ScopeName に対応する既存のスコープを更新します。 指定せず、同じ名前のスコープが存在する場合、コマンドレットはエラーをスローします。 |
例
PS> Register-SPWorkflowService -SPSite "https://myserver/mysitecollection" -WorkflowHostUri "http://workflow.example.com:12291" -ScopeName "SharePoint2" -PartitionMode -AllowOAuthHttp -Force