AppFabric コマンドレットを使用した永続化ストアの構成

このトピックでは、指定したスコープ (ルート、Web サイト、アプリケーションなど) に関連付けられた構成ファイルに定義されたインスタンス ストアの構成値を、AppFabric のコマンドレットを使用して追加、取得、設定、または削除する方法について説明します。また、SQL Server 永続化データベースを作成および初期化するコマンドレット、または永続化関連の項目を SQL Server 永続化ストアから削除するコマンドレットについても説明します。

ヒント

AppFabric コマンドレットを対話形式で実行するには、Microsoft AppFabric 1.1 for Windows Server 用の Windows PowerShell コンソールを使用し、コマンドレットを入力して Enter キーを押します。AppFabric コマンドレットの実行に関する全般的な情報については、「AppFabric コマンドレットの実行」を参照してください。スコープ パラメーター (-SiteName、-VirtualPath、-Uri など) の詳細については、「コマンドレットのスコープ」を参照してください。パイプ パラメーター (ApplicationInfo および ServiceInfo) の詳細については「コマンドレット パイプ」を参照してください。

コマンドレットを使用してインスタンス ストア定義を追加、取得、設定、または削除するには

コマンドレット	[説明]
Add-ASAppSqlInstanceStore	指定した名前付き接続文字列を指す、または接続文字列を指すインスタンス ストア定義を追加します。コマンドレットの例を次に示します。 Add-ASAppSqlInstanceStore -root -Name TestInstanceStore -ConnectionStringName ApplicationServerWorkflowInstanceStoreConnectionString
Set-ASAppSqlInstanceStore	指定した名前付き接続文字列を指す、または接続文字列を指すインスタンス ストア定義を設定または更新します。コマンドレットの例を次に示します。 Set-ASAppSqlInstanceStore -root -Name TestInstanceStore -ConnectionStringName ApplicationServerWorkflowInstanceStoreConnectionString 名前付き接続文字列は、<connectionStrings> タグで指定されたレベルまたはそれより上のレベルに関連付けられた構成ファイルで定義されます。
Remove-ASAppSqlInstanceStore	指定したスコープに関連付けられた構成ファイル内のインスタンス ストア定義を削除します。Name パラメーターの値は、削除するインスタンス ストアの名前を指定します。コマンドレットの例を次に示します。 Remove-ASAppSqlInstanceStore –root –Name TestInstanceStore ストア定義は、<Microsoft.ApplicationServer>\<Persistence>\<InstanceStores> ノードにある構成ファイルで確認できます。
Get-ASAppInstanceStore	指定したスコープに関連付けられたインスタンス ストアに関する情報を取得します。この情報には、インスタンス ストアの名前、ストアのストア プロバイダーの名前、サイト名、仮想パス、およびインスタンス ストアに関する任意のパラメーター (SQL ワークフロー インスタンス ストアの接続文字列など) が含まれます。コマンドレットの例を次に示します。 Get-ASAppInstanceStore –root

Add-ASAppSqlInstanceStore コマンドレットの構文オプション

Add-ASAppSqlInstanceStore [-Root] -Name <String> [-ConnectionString <String>] [-ConnectionStringName <String>] [<CommonParameters>]

Add-ASAppSqlInstanceStore [-SiteName] <String> [[-VirtualPath] <String>] -Name <String> [-ConnectionString <String>] [-ConnectionStringName <String>] [<CommonParameters>]

Add-ASAppSqlInstanceStore [-Uri] <Uri> -Name <String> [-ConnectionString <String>] [-ConnectionStringName <String>] [<CommonParameters>]

Add-ASAppSqlInstanceStore -ApplicationObject <ApplicationInfo> -Name <String> [-ConnectionString <String>] [-ConnectionStringName <String>] [<CommonParameters>]

Add-ASAppSqlInstanceStore コマンドレットに固有のパラメーターを次の表に示します。

[パラメーター]	[説明]
プロジェクト名	指定したスコープ (ルート、サイト、アプリケーションなど) に関連付けられた構成ファイル内のインスタンス ストア定義の名前。
ConnectionString	ストアへの接続に使用する接続文字列。
ConnectionStringName	構成ファイルに定義された接続文字列定義の名前。

Set-ASAppSqlInstanceStore コマンドレットの構文オプション

Set-ASAppSqlInstanceStore [-Root] -Name <String> [-Confirm] [-ConnectionString <String>] [-ConnectionStringName <String>] [-WhatIf] [<CommonParameters>]

Set-ASAppSqlInstanceStore [-SiteName] <String> [[-VirtualPath] <String>] -Name <String> [-Confirm] [-ConnectionString <String>] [-ConnectionStringName <String>] [-WhatIf] [<CommonParameters>]

Set-ASAppSqlInstanceStore [-Uri] <Uri> -Name <String> [-Confirm] [-ConnectionString <String>] [-ConnectionStringName <String>] [-WhatIf] [<CommonParameters>]

Set-ASAppSqlInstanceStore -ApplicationObject <ApplicationInfo> -Name <String> [-Confirm] [-ConnectionString <String>] [-ConnectionStringName <String>] [-WhatIf] [<CommonParameters>]

Set-ASAppSqlInstanceStore コマンドレットに固有のパラメーターを次の表に示します。

[パラメーター]	[説明]
プロジェクト名	指定したスコープ (ルート、サイト、アプリケーションなど) に関連付けられた構成ファイル内のインスタンス ストア定義の名前。
ConnectionString	ストアへの接続に使用する接続文字列。
ConnectionStringName	構成ファイルに定義された接続文字列定義の名前。

Remove-ASAppSqlInstanceStore コマンドレットの構文オプション

Remove-ASAppSqlInstanceStore [-Root] -Name <String> [-Confirm] [-WhatIf] [<CommonParameters>]

Remove-ASAppSqlInstanceStore [-SiteName] <String> [[-VirtualPath] <String>] -Name <String> [-Confirm] [-WhatIf] [<CommonParameters>]

Remove-ASAppSqlInstanceStore [-Uri] <Uri> -Name <String> [-Confirm] [-WhatIf] [<CommonParameters>]

Remove-ASAppSqlInstanceStore -ApplicationObject <ApplicationInfo> -Name <String> [-Confirm] [-WhatIf] [<CommonParameters>]

Remove-ASAppSqlInstanceStore コマンドレットに固有のパラメーターを次の表に示します。

[パラメーター]	[説明]
プロジェクト名	指定したスコープ (ルート、サイト、アプリケーションなど) に関連付けられた構成ファイル内のインスタンス ストア定義の名前。

Get-ASAppInstanceStore コマンドレットの構文オプション

Get-ASAppInstanceStore [-Root] [-Name <String>] [<CommonParameters>]

Get-ASAppInstanceStore [-SiteName] <String> [[-VirtualPath] <String>] [-Name <String>] [<CommonParameters>]

Get-ASAppInstanceStore [-Uri] <Uri> [-Name <String>] [<CommonParameters>]

Get-ASAppInstanceStore -ApplicationObject <ApplicationInfo> [-Name <String>] [<CommonParameters>]

Get-ASAppInstanceStore コマンドレットに固有のパラメーターを次の表に示します。

[パラメーター]	[説明]
プロジェクト名	指定したスコープ (ルート、サイト、アプリケーションなど) に関連付けられた構成ファイル内のインスタンス ストア定義の名前。

コマンドレットを使用して SQL Server 永続化データベースを初期化または削除するには

コマンドレット	[説明]
Initialize-ASPersistenceSqlDatabase	SQL Server 永続化データベースがサーバーにまだ存在しない場合は、指定したデータベース サーバーに指定したデータベースを作成し、初期化します。初期化プロセスにより、永続化関連の項目 (テーブル、ビュー、ストアド プロシージャなど) が作成されます。データベースがサーバーに既に存在する場合は、永続化項目を使用してデータベースが初期化されます。また、指定した Windows グループが対応する SQL Server ロールに追加されます。コマンドレットの例を次に示します。 Initialize-ASPersistenceSqlDatabase -Database TempPersistenceDB -Server "(local)"
Remove-ASPersistenceSqlDatabase	指定したデータベースからすべての永続化項目 (ストアド プロシージャ、テーブル、ビューなど) を削除しますが、データベース自体は削除しません。コマンドレットの例を次に示します。 Remove-ASPersistenceSqlDatabase -Database TempPersistenceDB -Server "(local)"

Initialize-ASPersistenceSqlDatabase コマンドレットの構文オプション

Initialize-ASPersistenceSqlDatabase -Database <String> [-Admins <String>] [-Confirm] [-Force] [-Readers <String>] [-Server <String>] [-Users <String>] [-WhatIf] [<CommonParameters>]

Initialize-ASPersistenceSqlDatabase -ConnectionString <String> [-Admins <String>] [-Confirm] [-Force] [-Readers <String>] [-Users <String>] [-WhatIf] [<CommonParameters>]

Initialize-ASPersistenceSqlDatabase コマンドレットに固有のパラメーターを次の表に示します。

[パラメーター]	[説明]
サーバー	データベースが置かれているサーバーの名前。
データベース	SQL Server 永続化データベースの名前。
ConnectionString	SQL Server 永続化データベースへの接続に使用する接続文字列。 サーバーとデータベースを指定するか、SQL Server 永続化データベースへの接続に使用する接続文字列を指定できます。
Admins	指定した Windows グループを、指定した SQL Server 永続化データベース内の InstanceStoreObservers、WorkflowActivationUsers、WorkflowAdministrators、および WorkflowManagementServiceUsers ロールに追加します。
閲覧者	指定した Windows グループを、指定した SQL Server 永続化データベース内の InstanceStoreObservers ロールに追加します。
[ユーザー]	指定した Windows グループを、指定した SQL Server 永続化データベース内の InstanceStoreUsers ロールに追加します。

Remove-ASPersistenceSqlDatabase コマンドレットの構文オプション

Remove-ASPersistenceSqlDatabase -Database <String> [-Force] [-Server <String>] [<CommonParameters>]

Remove-ASPersistenceSqlDatabase -ConnectionString <String> [-Force] [<CommonParameters>]

Remove-ASPersistenceSqlDatabase コマンドレットに固有のパラメーターを次の表に示します。

[パラメーター]	[説明]
サーバー	データベースが置かれているサーバーの名前。
データベース	SQL Server 永続化データベースの名前。
ConnectionString	SQL Server 永続化データベースへの接続に使用する接続文字列。 サーバーとデータベースを指定するか、SQL Server 永続化データベースへの接続に使用する接続文字列を指定できます。

  2012-03-05