Skriptgesteuerte Konfiguration von AppFabric
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:
Öffnen Sie eine Eingabeaufforderung als Administrator.
Navigieren Sie zu dem Ordner, der die Beispieldateien mit der Endung ps1 enthält.
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:
Hinzufügen des AppFabric-Administrators zu lokalen Administratorgruppe
Festlegen der Konfiguration des Ereigniserfassungsdiensts
Festlegen der Konfiguration des Workflowverwaltungsdiensts
Hinzufügen von Verbindungszeichenfolgen zum Abschnitt für Verbindungszeichenfolgen in der Web.config-Stammdatei
Erstellen eines Instanzspeichereintrags für die Verbindungszeichenfolge des Persistenzspeichers
Festlegen des Persistenzverhaltens
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:
Entfernen des AppFabric-Administrators aus lokalen Administratorgruppe
Der Administrator muss im Skript zum Zurücksetzen der Konfiguration so angepasst werden, dass er dem in der Konfiguration real verwendeten Benutzer entspricht.
Zurücksetzen der Konfiguration des Ereigniserfassungsdiensts
Zurücksetzen der Konfiguration des Workflowverwaltungsdiensts
Entfernen des Persistenzverhaltens
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