Skriptgesteuerte Konfiguration von AppFabric

  • Artikel

Dieses Beispiel führt Sie schrittweise durch die Aktionen, die für die Konfiguration von AppFabric erforderlich sind, damit Domänenkonten in Verbindung mit der integrierten Sicherheitsauthentifizierung für die Herstellung der Verbindung zu einer Remotedatenbank verwendet werden können.

Hinweis

Beispiele werden nur zu Anschauungszwecken bereitgestellt. Sie sind nicht für die Verwendung in einer Produktionsumgebung gedacht und wurden nicht in einer Produktionsumgebung getestet. Microsoft bietet keinen technischen Support für diese Beispiele.

Voraussetzungen

Die Benutzer sollten mit der Skripterstellung in Windows PowerShell, den allgemeinen Skriptkonzepten sowie mit dem Sicherheitsmodell von AppFabric vertraut sein. Das Beispiel setzt Folgendes voraus:

  • Die standardmäßige AppFabric-Installation wurde durchgeführt

  • Die Datenbanken wurden vorbereitet. (Die Überwachungs- und Persistenzdatenbanken wurden mit den richtigen Sicherheitseinstellungen auf einem Remotecomputer initialisiert.)

    • Datenbanken können mit den folgenden Cmdlets vorbereitet werden: Initialize-ASMonitoringDatabase, Initialize-ASPersistenceSqlDatabase

    • Die Datenbanken können im Skript durch Bearbeiten der Variablen $Persistence_ConnectionStringName, $Persistence_ConnectionString, $Monitoring_ConnectionString und $Monitoring_ConnectionStringName im Abschnitt User Defined Variables des Beispiels angepasst werden.

  • Es wurden Domänenbenutzer und -gruppen erstellt. Das Beispiel ist mit Werten, die der folgenden Tabelle entsprechen, voraufgefüllt.

Domäne: corp.contoso.com

AppFabric-Rolle Domänengruppe Domänenbenutzer

Administratoren

AS_Administrators

dubAdmin

Benutzer

AS_Users

dubUser

Beobachter

AS_Observers

dubObserver

  • Die Benutzer in der Administratorrolle müssen über das Recht „Als Dienst anmelden“ verfügen, da sie die Ereignisauflistungs- und Workflowverwaltungsdienste ausführen.

  • Die Identität des Anwendungspools, der zum Ausführen von AppFabric-Anwendungen verwendet wird, muss Mitglieder der Rolle Benutzer sein.

  • Bei dem Anwendungspool muss es sich um einen .NET Framework 4-Anwendungspool handeln.

Beispielspeicherort und -dateien

Das Beispiel umfasst die folgenden Dateien:

  • Readme.mhtml

  • code\scriptedConfigurationOfDublin.ps1

  • code\scriptedUnconfigurationOfDublin.ps1

Einrichten und Ausführen dieses Beispiels

Gehen Sie zum Ausführen dieses Skripts folgendermaßen vor:

  1. Öffnen Sie eine Eingabeaufforderung als Administrator.

  2. Navigieren Sie zu dem Ordner, der die Beispieldateien mit der Endung ps1 enthält.

  3. Führen Sie den folgenden Befehl aus: powershell -ExecutionPolicy RemoteSigned -File scriptedConfigurationOfDublin.ps1

Informationen zum Verständnis dieses Beispiels

Das Skript weist vier Funktionen und drei Abschnitte auf.

Funktionen

  • GetUserCredential fordert den Benutzer auf, einen Benutzernamen und ein Kennwort anzugeben und speichert diese Informationen sicher in einem PSCredential-Objekt, das vom Skript verwendet wird.

  • Setzer ändert den Benutzernamen und das Kennwort für die Anmeldung bei einem angegebenen Dienst.

  • GetSqlConnectionString generiert eine SQL-Verbindungszeichenfolge für den angegebenen Server und die Datenbank.

  • UpdateConnectionString fügt die angegebene Verbindungszeichenfolge der Konfigurationsdatei Web.config im Stammordner hinzu oder aktualisiert diese.

Abschnitte

  • Im Abschnitt User Defined Variables finden Sie eine Liste der im Skript verwendeten Variablen. Sie können diese Variablen ändern, um das Skript an die Besonderheiten der Umgebung anzupassen.

  • Im Abschnitt Collect Credentials ruft das Skript die Funktion GetUserCredential auf, um die Anmeldeinformationen des Benutzers für die Verwendung bei der Konfiguration der Systemdienste (Workflowverwaltungsdienst und Ereigniserfassungsdienst) abzurufen.

  • Im Abschnitt Update Configuration wird die Konfiguration basierend auf den definierten Variablen und erfassten Informationen angewendet.

Das Skript führt die folgenden Konfigurationsaktionen durch:

  1. Hinzufügen des AppFabric-Administrators zu lokalen Administratorgruppe

  2. Festlegen der Konfiguration des Ereigniserfassungsdiensts

  3. Festlegen der Konfiguration des Workflowverwaltungsdiensts

  4. Hinzufügen von Verbindungszeichenfolgen zum Abschnitt für Verbindungszeichenfolgen in der Web.config-Stammdatei

  5. Erstellen eines Instanzspeichereintrags für die Verbindungszeichenfolge des Persistenzspeichers

  6. Festlegen des Persistenzverhaltens

  7. Festlegen des Überwachungsverhaltens

Entfernen dieses Beispiels

Führen Sie zum Zurücksetzen der Konfiguration scriptedUnConfigurationOfDublin.ps1 aus.

powershell -ExecutionPolicy RemoteSigned -File scriptedUnConfigurationOfDublin.ps1

Das Skript führt die folgenden Aktionen durch:

  1. Entfernen des AppFabric-Administrators aus lokalen Administratorgruppe

  2. Der Administrator muss im Skript zum Zurücksetzen der Konfiguration so angepasst werden, dass er dem in der Konfiguration real verwendeten Benutzer entspricht.

  3. Zurücksetzen der Konfiguration des Ereigniserfassungsdiensts

  4. Zurücksetzen der Konfiguration des Workflowverwaltungsdiensts

  5. Entfernen des Persistenzverhaltens

  6. Entfernen der Instanzspeicherregistrierung aus der Verbindungszeichenfolge für die Persistenzdatenbank

Nachdem Sie das Skript ausgeführt haben, müssen Sie das folgende Überwachungsverhalten manuell aus der Web.config-Stammdatei löschen:

<default enabled="true" connectionStringName="monitoringDB" monitoringLevel="HealthMonitoring" />

Darüber hinaus müssen auch alle Verbindungszeichenfolgen, die vom Konfigurationsskript hinzugefügt wurden, manuell entfernt werden.

  2011-12-05