Partager via


Configuration des magasins de persistance à l'aide des cmdlets de Windows Server AppFabric

Cette rubrique décrit l'utilisation des cmdlets de AppFabric pour ajouter, obtenir, définir ou supprimer des valeurs de configuration pour un magasin d'instances défini dans un fichier de configuration associé à l'étendue spécifiée (racine, site Web, application, etc.). Elle décrit également les cmdlets qui permettent de créer et d'initialiser une base de données de persistance SQL Server ou de supprimer les artefacts liés à la persistance d'un magasin de persistance SQL Server.

Notes

Pour exécuter une cmdlet de AppFabric de manière interactive, vous devez utiliser la console Windows PowerShell pour Windows Server AppFabric, entrer la cmdlet appropriée, puis appuyer sur Entrée. Pour plus d'informations sur l'exécution des cmdlets de AppFabric, consultez la rubrique Exécution des cmdlets de Windows Server AppFabric. Pour plus d'informations sur les paramètres d'étendue (-SiteName, -VirtualPath, -Uri, etc.), consultez la rubrique Étendue des cmdlets. Pour plus d'informations sur les paramètres de chaînage (ApplicationInfo et ServiceInfo), consultez la rubrique Chaînage des cmdlets.

Ajout, obtention, définition et suppression de définitions de magasin d'instances à l'aide de cmdlets

Cmdlet

Description

Add-ASAppSqlInstanceStore

Ajoute une définition de magasin d'instances pointant vers la chaîne de connexion nommée ou une chaîne de connexion. Exemple :

Add-ASAppSqlInstanceStore -root -Name TestInstanceStore -ConnectionStringName ApplicationServerWorkflowInstanceStoreConnectionString

Set-ASAppSqlInstanceStore

Définit ou met à jour une définition de magasin d'instances afin que celle-ci pointe vers la chaîne de connexion nommée ou une chaîne de connexion. Exemple :

Set-ASAppSqlInstanceStore -root -Name TestInstanceStore -ConnectionStringName ApplicationServerWorkflowInstanceStoreConnectionString

La chaîne de connexion nommée est définie dans le fichier de configuration associé au niveau spécifié ou aux niveaux supérieurs dans la balise <connectionStrings>.

Remove-ASAppSqlInstanceStore

Supprime l'enregistrement d'un magasin d'instances dans le fichier de configuration associé à l'étendue spécifiée. La valeur du paramètre Name spécifie le nom du magasin d'instances à supprimer. Exemple :

Remove-ASAppSqlInstanceStore –root –Name TestInstanceStore

Les définitions de magasin sont accessibles dans le fichier de configuration sous le nœud <Microsoft.ApplicationServer>\<Persistence>\<InstanceStores>.

Get-ASAppInstanceStore

Obtient les informations sur le magasin d'instances associé à l'étendue spécifiée. Ces informations incluent le nom du magasin d'instances, le nom du fournisseur du magasin, le nom du site, le chemin d'accès virtuel et les paramètres du magasin d'instances tels que la chaîne de connexion d'un magasin d'instances de flux de travail SQL. Exemple :

Get-ASAppInstanceStore –root

Options de syntaxe de la 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>]

Le tableau suivant répertorie les paramètres spécifiques de la cmdlet Add-ASAppSqlInstanceStore.

Paramètre

Description

Name

Nom de la définition de magasin d'instances dans le fichier de configuration associé à l'étendue spécifiée (racine, site, application, etc.).

ConnectionString

Chaîne de connexion utilisée pour la connexion au magasin.

ConnectionStringName

Nom de la définition de chaîne de connexion dans le fichier de configuration.

Options de syntaxe de la 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>]

Le tableau suivant répertorie les paramètres spécifiques de la cmdlet Set-ASAppSqlInstanceStore.

Paramètre

Description

Name

Nom de la définition de magasin d'instances dans le fichier de configuration associé à l'étendue spécifiée (racine, site, application, etc.).

ConnectionString

Chaîne de connexion utilisée pour la connexion au magasin.

ConnectionStringName

Nom de la définition de chaîne de connexion dans le fichier de configuration.

Options de syntaxe de la 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>]

Le tableau suivant répertorie les paramètres spécifiques de la cmdlet Remove-ASAppSqlInstanceStore.

Paramètre

Description

Name

Nom de la définition de magasin d'instances dans le fichier de configuration associé à l'étendue spécifiée (racine, site, application, etc.).

Options de syntaxe de la 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>]

Le tableau suivant répertorie les paramètres spécifiques de la cmdlet Get-ASAppSqlInstanceStore.

Paramètre

Description

Name

Nom de la définition de magasin d'instances dans le fichier de configuration associé à l'étendue spécifiée (racine, site, application, etc.).

Initialisation ou suppression des bases de données de persistance SQL Server à l'aide de cmdlets

Cmdlet

Description

Initialize-ASPersistenceSqlDatabase

Crée et initialise une base de données de persistance SQL Server sur le serveur de base de données spécifié (si la base de données spécifiée n'existe pas déjà sur le serveur). Le processus d'initialisation crée les artefacts liés à la persistance (tables, vues, procédures stockées, etc.). Si la base de données existe déjà sur le serveur, la cmdlet initialise la base de données avec les artefacts de persistance. Elle ajoute également le groupe Windows spécifié aux rôles SQL Server correspondants. Exemple :

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

Remove-ASPersistenceSqlDatabase

Supprime tous les artefacts de persistance (procédures stockées, tables, vues, etc.) de la base de données spécifiée, mais ne supprime pas la base de données elle-même. Exemple :

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

Options de syntaxe de la 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>]

Le tableau suivant répertorie les paramètres spécifiques de la cmdlet Initialize-ASPersistenceSqlDatabase.

Paramètre

Description

Server

Nom du serveur sur lequel réside la base de données.

Database

Nom de la base de données de persistance SQL Server.

ConnectionString

Chaîne de connexion utilisée pour la connexion à une base de données de persistance SQL Server.

Vous pouvez soit spécifier un serveur et une base de données, soit spécifier une chaîne de connexion utilisée pour la connexion à une base de données de persistance SQL.

Admins

Ajoute le groupe Windows spécifié aux rôles InstanceStoreObservers, WorkflowActivationUsers, WorkflowAdministrators et WorkflowManagementServiceUsers dans la base de données de persistance SQL Server spécifiée.

Readers

Ajoute le groupe Windows spécifié au rôle InstanceStoreObservers dans la base de données de persistance SQL Server spécifiée.

Users

Ajoute le groupe Windows spécifié au rôle InstanceStoreUsers dans la base de données de persistance SQL Server spécifiée.

Options de syntaxe de la cmdlet Remove-ASPersistenceSqlDatabase

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

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

Le tableau suivant répertorie les paramètres spécifiques de la cmdlet Remove-ASPersistenceSqlDatabase.

Paramètre

Description

Server

Nom du serveur sur lequel réside la base de données.

Database

Nom de la base de données de persistance SQL Server.

ConnectionString

Chaîne de connexion utilisée pour la connexion à une base de données de persistance SQL Server.

Vous pouvez soit spécifier un serveur et une base de données, soit spécifier une chaîne de connexion utilisée pour la connexion à une base de données de persistance SQL.

  2011-12-05