Windows Server AppFabric コマンドレットを使用したワークフロー永続化の構成
AppFabric のコマンドレットを使用して、ワークフロー サービスの SQL Server 永続化設定を取得または設定することができます。 永続化機能の設定は、特定のワークフロー サービスのサービス レベルで構成することも、サーバー、サイト、またはアプリケーションのスコープに対して構成して、これらの上位レベルでの定義をサービスに継承させることもできます。 IIS 階層で構成がどのように機能するかの詳細については、「Windows Server AppFabric での構成プロセス」を参照してください。
ヒント
AppFabric コマンドレットを対話形式で実行するには、Windows Server AppFabric 用の Windows PowerShell コンソールを使用し、コマンドレットを入力して Enter キーを押します。 AppFabric コマンドレットの実行に関する全般的な情報については、「Windows Server AppFabric コマンドレットの実行」を参照してください。 スコープ パラメーター (-SiteName、-VirtualPath、-Uri など) の詳細については、「コマンドレットのスコープ」を参照してください。パイプ パラメーター (ApplicationInfo および ServiceInfo) の詳細については「コマンドレット パイプ」を参照してください。
このトピックでは、特定のワークフロー サービスに対する SQL Server 永続化機能を構成する方法を説明します。
ワークフロー サービスに対する SQL Server 永続化機能をコマンドレットを使用して構成するには
このセクションでは、AppFabric コマンドレットを使用して、指定したスコープに関連付けられた構成ファイル内の SQL Server 永続化関連の要素および属性の値を、取得、設定、消去する方法を説明します。
コマンドレット |
説明 |
Get-ASAppSqlServicePersistence |
指定のスコープに関連付けられた構成ファイル内の sqlWorkflowInstanceStore 要素で定義されている、永続化関連の要素と属性の値を取得します。 |
Set-ASAppSqlServicePersistence |
指定のスコープに関連付けられた構成ファイル内の sqlWorkflowInstanceStore 要素で定義されている、永続化関連の要素と属性の値を設定します。 |
Clear-ASAppSqlServicePersistence |
指定のスコープに関連付けられた構成ファイルから sqlWorkflowInstanceStore 要素を消去または削除します。 |
Get-ASAppSqlServicePersistence コマンドレットの構文オプションは次のとおりです。
// to get workflow service persistence settings at the root level
Get-ASAppSqlServicePersistence -Root
// to get workflow service persistence settings at the Web site level
Get-ASAppSqlServicePersistence -SiteName <String>
// to get workflow service persistence settings at the virtual application or service level that the VirtualPath points to
Get-ASAppSqlServicePersistence -SiteName <String> -VirtualPath <String>]
// to get workflow service persistence settings at the site, virtual application or service level that the Uri points to
Get-ASAppSqlServicePersistence -Uri <Uri>
// to get workflow service persistence settings at the application level specified by the ApplicationObject.
Get-ASAppSqlServicePersistence -ApplicationObject <ApplicationInfo>
// Ex: Get-ASApplication -SiteName "Default Web Site" -VirtualPath /SampleApp | Get-ASAppSqlServicePersistence
// to get workflow service persistence settings at the service level specified by the Service Object
Get-ASAppSqlServicePersistence -ServiceObject <ServiceInfo>
// Ex: Get-ASApplicationService –SiteName “Default Web Site” –VirtualPath “/SampleApp/SampleService.xamlx” | Get-ASAppSqlServicePersistence
Set-ASAppSqlServicePersistence コマンドレットの構文オプションは次のとおりです。
Set-ASAppSqlServicePersistence [-SiteName] <String> [[-VirtualPath] <String>] [-ConnectionString <String>] [-ConnectionStringName <String>] [-EnableNetPipeProtocol] [-HostLockRenewalPeriod <TimeSpan>] [-InstanceCompletionAction {DeleteAll | DeleteNothing}] [-InstanceEncodingOption {GZip | None}] [-InstanceLockedExceptionAction {AggressiveRetry | BasicRetry | NoRetry}] [-RunnableInstancesDetectionPeriod <Time>] [-UseInherited] [<CommonParameters>]
Set-ASAppSqlServicePersistence [-Uri] <Uri> [-ConnectionString <String>] [-ConnectionStringName <String>] [-EnableNetPipeProtocol] [-HostLockRenewalPeriod <TimeSpan>] [-InstanceCompletionAction {DeleteAll | DeleteNothing}] [-InstanceEncodingOption {GZip | None}] [-InstanceLockedExceptionAction {AggressiveRetry | BasicRetry | NoRetry}] [-RunnableInstancesDetectionPeriod <Time>] [-UseInherited] [<CommonParameters>]
Set-ASAppSqlServicePersistence -ApplicationObject <ApplicationInfo> [-ConnectionString <String>] [-ConnectionStringName <String>] [-EnableNetPipeProtocol] [-HostLockRenewalPeriod <TimeSpan>] [-InstanceCompletionAction {DeleteAll | DeleteNothing}] [-InstanceEncodingOption {GZip | None}] [-InstanceLockedExceptionAction {AggressiveRetry | BasicRetry | NoRetry}] [-RunnableInstancesDetectionPeriod <Time>] [-UseInherited] [<CommonParameters>]
Set-ASAppSqlServicePersistence -ServiceObject <ServiceInfo> [-ConnectionString <String>] [-ConnectionStringName <String>] [-EnableNetPipeProtocol] [-HostLockRenewalPeriod <TimeSpan>] [-InstanceCompletionAction {DeleteAll | DeleteNothing}] [-InstanceEncodingOption {GZip | None}] [-InstanceLockedExceptionAction {AggressiveRetry | BasicRetry | NoRetry}] [-RunnableInstancesDetectionPeriod <Time>] [-UseInherited] [<CommonParameters>]
Set-ASAppSqlServicePersistence [-ConnectionString <String>] [-ConnectionStringName <String>] [-EnableNetPipeProtocol] [-HostLockRenewalPeriod <TimeSpan>] [-InstanceCompletionAction {DeleteAll | DeleteNothing}] [-InstanceEncodingOption {GZip | None}] [-InstanceLockedExceptionAction {AggressiveRetry | BasicRetry | NoRetry}] [-Root] [-RunnableInstancesDetectionPeriod <Time>] [-UseInherited] [<CommonParameters>]
次の表に示すパラメーターは、Set-ASAppSqlServicePersistence コマンドレットに固有のものです。
パラメーター |
説明 |
HostLockRenewalPeriod |
ワークフロー サービス インスタンスに対するロックが失効するまでの時間を指定します。ホストは、この時間が経過する前にロックを更新する必要があります。 指定した期間内にホストがロックを更新しなかった場合は、ワークフロー サービス インスタンスのロックは解除され、他のホストがそのインスタンスのロックを取得できるようになります。 |
InstanceCompletionAction |
ワークフロー サービス インスタンスが完了した後もインスタンス状態情報を永続化データベースに保持するかどうかを指定します。 このパラメーターに指定できる値は、 DeleteAll および DeleteNothing です。 |
InstanceEncodingOption |
インスタンス状態情報を永続化ストアに保存する前に、GZip アルゴリズムを使用してこの情報を圧縮するかどうかを指定します。 指定できる値は、GZip および None です。 |
InstanceLockedExceptionAction |
サービス ホストが InstanceLockedException を受け取ったときに行う操作を指定します。この例外は、ホストがロックしようとしたワークフロー サービス インスタンスが別のホストによってロックされているときに発生します。 このフィールドで使用できるオプションは NoRetry、BasicRetry、および AggressiveRetry です。 次に、これら 3 つのオプションについて説明します。
ヒント BasicRetry と AggressiveRetry のどちらでもタイムアウトは自動的に呼び出しのタイムアウトに設定され、構成することはできません。 |
RunnableInstancesDetectionPeriod |
期間を指定します。この期間後、SQL ワークフロー インスタンス ストアでは検出タスクを実行し、前の検出サイクル後に永続化データベースにある実行可能またはアクティブ化可能なワークフロー インスタンスを検出します。 |
ヒント
値を渡す必要があるのは、変更するパラメーターのみです。すべてのパラメーターの値を渡す必要はありません。
Clear-ASAppSqlServicePersistence コマンドレットの構文オプションは次のとおりです。
Clear-ASAppSqlServicePersistence -Root
Clear-ASAppSqlServicePersistence -SiteName <String>
Clear-ASAppSqlServicePersistence -SiteName <String> -VirtualPath <String>]
Clear-ASAppSqlServicePersistence -Uri <Uri>
Clear-ASAppSqlServicePersistence -ApplicationObject <ApplicationInfo>
// Ex: Get-ASApplication -SiteName "Default Web Site" -VirtualPath /SampleApp | Clear-ASAppSqlServicePersistence
Clear-ASAppSqlServicePersistence -ServiceObject <ServiceInfo>
// Ex: Get-ASApplicationService –SiteName “Default Web Site” –VirtualPath “/SampleApp/SampleService.xamlx” | Clear-ASAppSqlServicePersistence
2011-12-05