Konfigurieren von Persistenzspeichern mithilfe von Windows Server AppFabric-Cmdlets

In diesem Thema wird beschrieben, wie die AppFabric-Cmdlets zum Hinzufügen, Abrufen, Festlegen oder Entfernen von Konfigurationswerten für einen Instanzspeicher verwendet werden, der in einer Konfigurationsdatei definiert wurde, die dem angegebenen Bereich (Stamm, Website, Anwendung usw.) zugeordnet ist. Hierin werden auch die Cmdlets zum Erstellen und Initialisieren einer SQL Server-Persistenzdatenbank oder zum Entfernen von persistenzbezogenen Artefakten aus einem SQL Server-Persistenzspeicher beschrieben.

Hinweis

Wenn Sie ein AppFabric-Cmdlet interaktiv ausführen möchten, müssen Sie die Windows PowerShell-Konsole für Windows Server AppFabric verwenden, das entsprechende Cmdlet eingeben und dann die EINGABETASTE drücken. Weitere Informationen zum Ausführen von AppFabric-Cmdlets im Allgemeinen finden Sie unter Ausführen von Windows Server AppFabric-Cmdlets. Ausführliche Informationen zu Bereichsparametern (-SiteName, -VirtualPath, -Uri usw.) finden Sie unter Cmdlet-Geltungsbereich. Ausführliche Informationen zu Pipingparametern (ApplicationInfo und ServiceInfo) finden Sie unter Piping von Cmdlets.

Hinzufügen, Abrufen, Festlegen oder Entfernen von Instanzspeicherdefinitionen mithilfe von Cmdlets

Cmdlet

Beschreibung

Add-ASAppSqlInstanceStore

Fügt eine Instanzspeicherdefinition hinzu, die auf die angegebene benannte Verbindungszeichenfolge oder auf eine Verbindungszeichenfolge verweist. Ein Beispiel für das Cmdlet:

Add-ASAppSqlInstanceStore -root -Name TestInstanceStore -ConnectionStringName ApplicationServerWorkflowInstanceStoreConnectionString

Set-ASAppSqlInstanceStore

Legt eine Instanzspeicherdefinition hinzu, die auf die angegebene benannte Verbindungszeichenfolge oder auf eine Verbindungszeichenfolge verweist, oder aktualisiert diese. Ein Beispiel für das Cmdlet:

Set-ASAppSqlInstanceStore -root -Name TestInstanceStore -ConnectionStringName ApplicationServerWorkflowInstanceStoreConnectionString

Die benannte Verbindungszeichenfolge ist in der Konfigurationsdatei definiert, die der angegebenen Ebene oder höheren Ebenen im Tag <connectionStrings> zugeordnet ist.

Remove-ASAppSqlInstanceStore

Entfernt eine Instanzspeicherregistrierung aus der Konfigurationsdatei, die dem angegebenen Bereich zugeordnet ist. Der Wert des Parameters Name gibt den Namen der zu entfernenden Instanz an. Ein Beispiel für das Cmdlet:

Remove-ASAppSqlInstanceStore –root –Name TestInstanceStore

Sie finden Speicherdefinitionen in einer Konfigurationsdatei im Knoten <Microsoft.ApplicationServer>\<Persistence>\<InstanceStores>.

Get-ASAppInstanceStore

Ruft Informationen zu dem Instanzspeicher ab, der dem angegebenen Bereich zugeordnet ist. Zu diesen Informationen gehören der Name des Instanzspeichers, der Name des Speicheranbieters, der Sitename, der virtuelle Pfad sowie alle Parameter des Instanzspeichers wie die Verbindungszeichenfolge für einen Workflowinstanzspeicher. Ein Beispiel für das Cmdlet:

Get-ASAppInstanceStore –root

Syntaxoptionen für das Cmdlet „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>]

In der folgenden Tabelle werden die Parameter aufgelistet, die für das Cmdlet Add-ASAppSqlInstanceStore spezifisch sind.

Parameter

Beschreibung

Name

Name der Instanzspeicherdefinition in der Konfigurationsdatei, die dem angegebenen Bereich (Stamm, Site, Anwendung usw.) zugeordnet ist.

ConnectionString

Eine Verbindungszeichenfolge, die für die Herstellung der Verbindung zu dem Speicher verwendet wird.

ConnectionStringName

Name der Verbindungszeichenfolgendefinition, die in einer Konfigurationsdatei definiert ist.

Syntaxoptionen für das Cmdlet „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>]

In der folgenden Tabelle werden die Parameter aufgelistet, die für das Cmdlet Set-ASAppSqlInstanceStore spezifisch sind.

Parameter

Beschreibung

Name

Name der Instanzspeicherdefinition in der Konfigurationsdatei, die dem angegebenen Bereich (Stamm, Site, Anwendung usw.) zugeordnet ist.

ConnectionString

Eine Verbindungszeichenfolge, die für die Herstellung der Verbindung zu dem Speicher verwendet wird.

ConnectionStringName

Name der Verbindungszeichenfolgendefinition, die in einer Konfigurationsdatei definiert ist.

Syntaxoptionen für das Cmdlet „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>]

In der folgenden Tabelle werden die Parameter aufgelistet, die für das Cmdlet Remove-ASAppSqlInstanceStore spezifisch sind.

Parameter

Beschreibung

Name

Name der Instanzspeicherdefinition in der Konfigurationsdatei, die dem angegebenen Bereich (Stamm, Site, Anwendung usw.) zugeordnet ist.

Syntaxoptionen für das Cmdlet „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>]

In der folgenden Tabelle werden die Parameter aufgelistet, die für das Cmdlet Get-ASAppInstanceStore spezifisch sind.

Parameter

Beschreibung

Name

Name der Instanzspeicherdefinition in der Konfigurationsdatei, die dem angegebenen Bereich (Stamm, Site, Anwendung usw.) zugeordnet ist.

Initialisieren oder Entfernen von SQL Server-Persistenzdatenbanken mithilfe von Cmdlets

Cmdlet

Beschreibung

Initialize-ASPersistenceSqlDatabase

Erstellt und initialisiert eine SQL Server-Persistenzdatenbank auf dem angegebenen Datenbankserver, wenn die angegebene Datenbank auf dem Server noch nicht vorhanden ist. Im Rahmen des Initialisierungsprozesses werden persistenzbezogene Artefakte (Tabellen, Ansichten, gespeicherte Prozeduren usw.) erstellt. Wenn die Datenbank auf dem Server bereits vorhanden ist, initialisiert das Cmdlet die Datenbank mit den Persistenzartefakten. Das Cmdlet fügt den entsprechenden SQL Server-Rollen zudem die angegebenen Windows-Gruppen hinzu. Ein Beispiel für das Cmdlet:

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

Remove-ASPersistenceSqlDatabase

Entfernt alle Persistenzartefakte (gespeicherte Prozeduren, Tabellen, Ansichten usw.) aus der angegebenen Datenbank, jedoch nicht die eigentliche Datenbank. Ein Beispiel für das Cmdlet:

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

Syntaxoptionen für das Cmdlet „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>]

In der folgenden Tabelle werden die Parameter aufgelistet, die für das Cmdlet Initialize-ASPersistenceSqlDatabase spezifisch sind.

Parameter

Beschreibung

Server

Name des Servers, auf dem sich die Datenbank befindet.

Database

Name der SQL Server-Persistenzdatenbank.

ConnectionString

Eine Verbindungszeichenfolge, die für die Herstellung der Verbindung zu einer SQL Server-Persistenzdatenbank verwendet wird.

Sie können entweder einen Server und eine Datenbank oder eine Verbindungszeichenfolge angeben, die für die Herstellung der Verbindung zu einer SQL Server-Persistenzdatenbank verwendet wird.

Admins

Fügt den Rollen InstanceStoreObservers, WorkflowActivationUsers, WorkflowAdministrators und WorkflowManagementServiceUsers in der angegebenen SQL Server-Persistenzdatenbank die angegebene Windows-Gruppe hinzu.

Readers

Fügt der Rolle InstanceStoreObservers in der angegebenen SQL Server-Persistenzdatenbank die angegebene Windows-Gruppe hinzu.

Users

Fügt der Rolle InstanceStoreUsers in der angegebenen SQL Server-Persistenzdatenbank die angegebene Windows-Gruppe hinzu.

Syntaxoptionen für das Cmdlet „Remove-ASPersistenceSqlDatabase“

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

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

In der folgenden Tabelle werden die Parameter aufgelistet, die für das Cmdlet Remove-ASPersistenceSqlDatabase spezifisch sind.

Parameter

Beschreibung

Server

Name des Servers, auf dem sich die Datenbank befindet.

Database

Name der SQL Server-Persistenzdatenbank.

ConnectionString

Eine Verbindungszeichenfolge, die für die Herstellung der Verbindung zu einer SQL Server-Persistenzdatenbank verwendet wird.

Sie können entweder einen Server und eine Datenbank oder eine Verbindungszeichenfolge angeben, die für die Herstellung der Verbindung zu einer SQL Server-Persistenzdatenbank verwendet wird.

  2011-12-05