Configurare gli archivi salvataggi permanenti tramite i cmdlet di AppFabric

In questo argomento viene descritto come utilizzare i cmdlet di AppFabric per aggiungere, ottenere, impostare o rimuovere i valori di configurazione per un archivio di istanza definito in un file di configurazione associato a un ambito specificato (radice, sito Web, applicazione e via di seguito). Vengono inoltre descritti i cmdlet per creare e inizializzare un database di salvataggio permanente di SQL Server o per rimuovere gli artefatti relativi al salvataggio permanente da un archivio di salvataggio permanente SQL Server.

Nota

Per eseguire un cmdlet di AppFabric in modo interattivo, è necessario utilizzare la console Windows PowerShell per Microsoft AppFabric 1.1 per Windows Server, immettere il cmdlet appropriato e premere INVIO. Per ulteriori informazioni sull'esecuzione dei cmdlet di AppFabric in generale, vedere Esecuzione dei cmdlet di AppFabric. Per informazioni dettagliate sui parametri di ambito (-SiteName, -VirtualPath, -Uri e via di seguito), vedere Ambito di cmdlet e per informazioni dettagliate sui parametri di piping (ApplicationInfo e ServiceInfo), vedere Piping di cmdlet.

Per aggiungere, impostare o rimuovere le definizioni dell'archivio di istanza tramite i cmdlet

Cmdlet

Descrizione

Add-ASAppSqlInstanceStore

Aggiunge una definizione di archivio di istanza che punta alla stringa di connessione denominata specificata oppure a una stringa di connessione. Esempio di cmdlet:

Add-ASAppSqlInstanceStore -root -Name TestInstanceStore -ConnectionStringName ApplicationServerWorkflowInstanceStoreConnectionString

Set-ASAppSqlInstanceStore

Imposta o aggiorna una definizione di archivio di istanza in modo che punti alla stringa di connessione denominata specificata oppure a una stringa di connessione. Esempio di cmdlet:

Set-ASAppSqlInstanceStore -root -Name TestInstanceStore -ConnectionStringName ApplicationServerWorkflowInstanceStoreConnectionString

La stringa di connessione denominata viene definita nel file di configurazione associato al livello specificato o ai livelli superiori nel tag <connectionStrings>.

Remove-ASAppSqlInstanceStore

Rimuove una registrazione dell'archivio di istanza nel file di configurazione associato all'ambito specificato. Il valore per il parametro Name specifica il nome dell'archivio di istanza da rimuovere. Esempio di cmdlet:

Remove-ASAppSqlInstanceStore –root –Name TestInstanceStore

È possibile trovare le definizioni di archivio in un file di configurazione nel nodo <Microsoft.ApplicationServer>\<Persistence>\<InstanceStores>.

Get-ASAppInstanceStore

Ottiene le informazioni sull'archivio di istanza associato all'ambito specificato. Tali informazioni includono il nome dell'archivio di istanza, il nome del provider dell'archivio per l'archivio, il nome del sito, il percorso virtuale e tutti i parametri per l'archivio di istanza, ad esempio la stringa di connessione per SQL Workflow Instance Store. Esempio di cmdlet:

Get-ASAppInstanceStore –root

Opzioni di sintassi per il 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>]

Nella tabella seguente sono elencati i parametri specifici per il cmdlet Add-ASAppSqlInstanceStore.

Parametro

Descrizione

Nome

Nome della definizione di archivio di istanza nel file di configurazione associato all'ambito specificato (radice, sito, applicazione e così via).

ConnectionString

Stringa di connessione utilizzata per la connessione all'archivio.

ConnectionStringName

Nome della definizione di stringa di connessione definita in un file di configurazione.

Opzioni di sintassi per il 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>]

Nella tabella seguente sono elencati i parametri specifici per il cmdlet Set-ASAppSqlInstanceStore.

Parametro

Descrizione

Nome

Nome della definizione di archivio di istanza nel file di configurazione associato all'ambito specificato (radice, sito, applicazione e così via).

ConnectionString

Stringa di connessione utilizzata per la connessione all'archivio.

ConnectionStringName

Nome della definizione di stringa di connessione definita in un file di configurazione.

Opzioni di sintassi per il 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>]

Nella tabella seguente sono elencati i parametri specifici per il cmdlet Remove-ASAppSqlInstanceStore.

Parametro

Descrizione

Nome

Nome della definizione di archivio di istanza nel file di configurazione associato all'ambito specificato (radice, sito, applicazione e così via).

Opzioni di sintassi per il 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>]

Nella tabella seguente sono elencati i parametri specifici per il cmdlet Get-ASAppInstanceStore.

Parametro

Descrizione

Nome

Nome della definizione di archivio di istanza nel file di configurazione associato all'ambito specificato (radice, sito, applicazione e così via).

Per inizializzare o rimuovere i database di salvataggio permanente SQL Server tramite i cmdlet

Cmdlet

Descrizione

Initialize-ASPersistenceSqlDatabase

Crea e inizializza un database di salvataggio permanente SQL Server sul server di database specificato se il database specificato non esiste già sul server. Il processo di inizializzazione crea gli artefatti relativi al salvataggio permanente (tabelle, viste, stored procedure e via di seguito). Se il database esiste già sul server, il cmdlet lo inizializza con gli artefatti relativi al salvataggio permanente. Il cmdlet inoltre aggiunge i gruppi di Windows specificati ai ruoli SQL Server corrispondenti. Esempio di cmdlet:

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

Remove-ASPersistenceSqlDatabase

Rimuove tutti gli artefatti di salvataggio permanente (stored procedure, tabelle, viste e via di seguito) dal database specificato, ma non rimuove il database stesso. Esempio di cmdlet:

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

Opzioni di sintassi per il 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>]

Nella tabella seguente sono elencati i parametri specifici per il cmdlet Initialize-ASPersistenceSqlDatabase.

Parametro

Descrizione

Server

Nome del server in cui risiede il database.

Database

Nome del database di salvataggio permanente di SQL Server.

ConnectionString

Stringa di connessione utilizzata per la connessione a un database di salvataggio permanente di SQL Server.

È possibile specificare un server e un database oppure una stringa di connessione utilizzata per la connessione a un database di salvataggio permanente di SQL Server.

Admins

Aggiunger il gruppo di Windows specificato ai ruoli InstanceStoreObservers, WorkflowActivationUsers, WorkflowAdministrators e WorkflowManagementServiceUsers nel database di salvataggio permanente specificato di SQL Server.

Lettori

Aggiunge il gruppo di Windows specificato al ruolo InstanceStoreObservers nel database di salvataggio permanente specificato di SQL Server.

Utenti

Aggiunge il gruppo di Windows specificato al ruolo InstanceStoreUsers nel database di salvataggio permanente specificato di SQL Server.

Opzioni di sintassi per il cmdlet Remove-ASPersistenceSqlDatabase

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

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

Nella tabella seguente sono elencati i parametri specifici per il cmdlet Remove-ASPersistenceSqlDatabase.

Parametro

Descrizione

Server

Nome del server in cui risiede il database.

Database

Nome del database di salvataggio permanente di SQL Server.

ConnectionString

Stringa di connessione utilizzata per la connessione a un database di salvataggio permanente di SQL Server.

È possibile specificare un server e un database oppure una stringa di connessione utilizzata per la connessione a un database di salvataggio permanente di SQL Server.

  2012-03-05