使用 Windows Server AppFabric Cmdlet 來設定持續性儲存區

發行項
12/05/2011

此主題說明如何使用 AppFabric Cmdlet，在與指定範圍 (根目錄、網站、應用程式等) 關聯的組態檔中，新增、取得、設定或移除其中定義之執行個體儲存區的值。其中也說明可建立和初始化 SQL Server 持續性資料庫，或從 SQL Server 持續性儲存區移除與持續性相關之成品的 Cmdlet。

注意

若要以互動方式執行 AppFabric Cmdlet，您必須使用 Windows Server AppFabric 的 Windows PowerShell 主控台，輸入適當的 Cmdlet，然後按下 ENTER。如需以一般方式執行 AppFabric Cmdlet 的詳細資訊，請參閱執行 Windows Server AppFabric Cmdlet。如需有關範圍參數 (-SiteName、-VirtualPath 與 -Uri 等) 的詳細資訊，請參閱 Cmdlet 範圍；如需有關管道處理參數 (ApplicationInfo 與 ServiceInfo) 的詳細資訊，請參閱 Cmdlet 管道處理。

使用 Cmdlet 來新增、取得、設定或移除執行個體儲存區定義

Cmdlet	描述
Add-ASAppSqlInstanceStore	新增指向所指定具名連接字串的執行個體儲存區定義或連接字串。Cmdlet 範例： `Add-ASAppSqlInstanceStore -root -Name TestInstanceStore -ConnectionStringName ApplicationServerWorkflowInstanceStoreConnectionString`
Set-ASAppSqlInstanceStore	設定或更新指向所指定具名連接字串的執行個體儲存區定義或連接字串。Cmdlet 範例： `Set-ASAppSqlInstanceStore -root -Name TestInstanceStore -ConnectionStringName ApplicationServerWorkflowInstanceStoreConnectionString` 具名連接字串是在與指定等級或更高等級關聯之組態檔中的 <connectionStrings> 標記中定義。
Remove-ASAppSqlInstanceStore	移除在與指定範圍關聯之組態檔中註冊的執行個體儲存區。Name 參數的值指定要移除的執行個體儲存區名稱。Cmdlet 範例： `Remove-ASAppSqlInstanceStore –root –Name TestInstanceStore` 您可以在 <Microsoft.ApplicationServer>\<Persistence>\<InstanceStores> 節點的組態檔中，找到儲存區定義。
Get-ASAppInstanceStore	取得與指定範圍關聯之執行個體儲存區的相關資訊。此資訊包括執行個體儲存區名稱、該儲存區的儲存區提供者名稱、網站名稱、虛擬路徑以及該執行個體儲存區的任何參數 (例如，「SQL 工作流程執行個體儲存區」的連接字串)。Cmdlet 範例： `Get-ASAppInstanceStore –root`

Add-ASAppSqlInstanceStore Cmdlet 的語法選項

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 Cmdlet 專用的參數。

參數	描述
Name	與指定範圍 (根目錄、網站、應用程式等) 關聯之組態檔中的執行個體儲存區定義名稱。
ConnectionString	用來連線到儲存區的連接字串。
ConnectionStringName	定義於組態檔中的連接字串定義名稱。

Set-ASAppSqlInstanceStore Cmdlet 的語法選項

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 Cmdlet 專用的參數。

參數	描述
Name	與指定範圍 (根目錄、網站、應用程式等) 關聯之組態檔中的執行個體儲存區定義名稱。
ConnectionString	用來連線到儲存區的連接字串。
ConnectionStringName	定義於組態檔中的連接字串定義名稱。

Remove-ASAppSqlInstanceStore Cmdlet 的語法選項

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 Cmdlet 專用的參數。

參數	描述
Name	與指定範圍 (根目錄、網站、應用程式等) 關聯之組態檔中的執行個體儲存區定義名稱。

Get-ASAppInstanceStore Cmdlet 的語法選項

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 Cmdlet 專用的參數。

參數	描述
Name	與指定範圍 (根目錄、網站、應用程式等) 關聯之組態檔中的執行個體儲存區定義名稱。

使用 Cmdlet 來初始化或移除 SQL Server 持續性資料庫

Cmdlet

描述

Initialize-ASPersistenceSqlDatabase

在指定的資料庫伺服器上建立並初始化 SQL Server 持續性資料庫 (若伺服器上並無指定的資料庫存在)。初始化程序會建立與持續性相關的成品 (資料表、檢視、預存程序等)。若伺服器上已有該資料庫，則 Cmdlet 會使用持續性成品來初始化該資料庫。Cmdlet 也會將指定的 Windows 群組新增至對應的 SQL Server 角色。Cmdlet 範例：

Initialize-ASPersistenceSqlDatabase  -Database TempPersistenceDB -Server "(local)"

Remove-ASPersistenceSqlDatabase

從指定的資料庫移除所有持續性成品 (預存程序、資料表、檢視等)，但不移除該資料庫本身。Cmdlet 範例：

Remove-ASPersistenceSqlDatabase  -Database TempPersistenceDB -Server "(local)"

Initialize-ASPersistenceSqlDatabase Cmdlet 的語法選項

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 Cmdlet 專用的參數。

參數	描述
Server	資料庫所在的伺服器名稱。
Database	SQL Server 持續性資料庫的名稱。
ConnectionString	用來連線到 SQL Server 持續性資料庫的連接字串。您可以指定伺服器與資料庫，或指定用來連線到 SQL Server 持續性資料庫的連接字串。
Admins	在指定的 SQL Server 持續性資料庫中，將指定的 Windows 群組新增至 InstanceStoreObservers、WorkflowActivationUsers、WorkflowAdministrators 與 WorkflowManagementServiceUsers 角色。
Readers	在指定的 SQL Server 持續性資料庫中，將指定的 Windows 群組新增至 InstanceStoreObservers 角色。
Users	在指定的 SQL Server 持續性資料庫中，將指定的 Windows 群組新增至 InstanceStoreUsers 角色。

Remove-ASPersistenceSqlDatabase Cmdlet 的語法選項

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

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

下表列出 Remove-ASPersistenceSqlDatabase Cmdlet 專用的參數。

參數	描述
Server	資料庫所在的伺服器名稱。
Database	SQL Server 持續性資料庫的名稱。
ConnectionString	用來連線到 SQL Server 持續性資料庫的連接字串。您可以指定伺服器與資料庫，或指定用來連線到 SQL Server 持續性資料庫的連接字串。

2011-12-05

共用方式為