Cachekonfiguration mit Windows PowerShell (AppFabric 1.1-Cache)
Es gibt es zwei Möglichkeiten, den Microsoft AppFabric 1.1 für Windows Server-Cache-Dienst zu konfigurieren: mithilfe des AppFabric-Konfigurations-Assistenten und einer Reihe von Windows PowerShell-Befehlen für den AppFabric-Cache. In diesem Thema werden die Windows PowerShell-Befehle beschrieben. Weitere Informationen zum AppFabric-Konfigurations-Assistenten finden Sie unter Konfigurieren von AppFabric.
Wenn Sie einen Computer verwenden, auf dem die Cacheverwaltungsfunktion installiert ist, können Sie im Menü Start auf Alle Programme und dann auf Microsoft AppFabric 1.1 für Windows Server klicken. Klicken Sie anschließend auf Windows PowerShell-Cacheverwaltung. Anschließend müssen Sie das Windows PowerShell-Modul manuell importieren, das die Konfigurationsbefehle enthält. Dieser Vorgang wird im folgenden Beispiel veranschaulicht.
Import-Module DistributedCacheConfiguration
Hinweis
Sie müssen Windows PowerShell mit Administratorberechtigungen ausführen, damit einige der Verwaltungsbefehle ordnungsgemäß funktionieren. Klicken Sie mit der rechten Maustaste auf die Verknüpfung Windows PowerShell-Cacheverwaltung, und wählen Sie dann Als Administrator ausführen aus.
Befehlsnamenänderungen in den Update für AppFabric 1.1 (März 2012)
Das Update für AppFabric 1.1 (März 2012)-Update enthielt Namenänderungen der Windows PowerShell-Befehle für AppFabric. Diese Änderungen verbessern die Verständlichkeit und Konsistenz der Befehle. Die folgenden Tabellen enthalten den ursprünglichen Befehlsnamen (RTM) und den Befehlsnamen aus März 2012 (QFE).
Damit die Abwärtskompatibilität gewahrt bleibt, wurde ein PowerShell-Skript bereitgestellt, das die neuen Befehle über Aliase den alten Befehlsnamen zuordnet. Alle Parameternamenänderungen wurden als Aliase im PowerShell-Modul selbst zugeordnet.
Aufrufen der Hilfe in einer Windows Power-Sitzung
Die nachstehenden Informationen stellen eine Zusammenfassung der Verwaltungsbefehle für die Cachefunktionen von AppFabric dar. Es ist wichtig zu wissen, dass Sie auch in einer Windows PowerShell-Sitzung auf die Hilfe zugreifen können. So werden mit dem folgenden Befehl beispielsweise alle Konfigurationsbefehle angezeigt:
get-command -module DistributedCacheConfiguration
Wenn Sie Hilfe zu einem bestimmten Befehl benötigen, können Sie den Befehl get-help verwenden. So wird mit dem folgenden Befehl beispielsweise die vollständige Hilfe für den Befehl Add-CacheHost angezeigt:
get-help Add-CacheHost -full
Konfigurationsbefehle
Es gibt zwei Hauptkategorien für AppFabric-Cache-PowerShell-Befehle: Verwaltungsbefehle und Konfigurationsbefehle. Dieses Thema legt den Schwerpunkt auf die Konfigurationsbefehle. Weitere Informationen zu den Verwaltungsbefehlen finden Sie unter Verwenden von Windows PowerShell zum Verwalten von AppFabric 1.1-Cachefunktionen. Die folgende Tabelle enthält die Windows PowerShell-Befehle, mit denen der Cachedienst konfiguriert werden kann.
| Befehl (RTM) | Befehl (QFE) | Beschreibung |
|---|---|---|
|
|
Konfiguriert die Cacheverwaltung auf dem Cachehost. Dieser Befehl wird lokal auf dem Server ausgeführt. |
|
|
Konfiguriert einen Cachehost so, dass er Teil eines vorhandenen Clusters werden kann. Dieser Befehl wird lokal auf dem Server ausgeführt. |
|
|
Gibt die Cacheclusterinformationen zurück, einschließlich Details zu Initialisierungsstatus und Größe. |
|
|
Gibt die temporäre Verbindungszeichenfolge zurück, die mithilfe des Befehls „Set-CacheConnectionString“ festgelegt wurde. Beachten Sie, dass dieser Befehl nicht zwangsläufig die vom Cachecluster-Konfigurationsspeicher verwendete Verbindungszeichenfolge wiedergibt. Hinweis Dieser Befehl wird intern von Microsoft AppFabric 1.1 für Windows Server verwendet. Es sind keine Benutzerszenarien bekannt, die seine Verwendung erfordern. |
|
|
Erstellt und initialisiert einen neuen Cachecluster-Konfigurationsspeicher. |
|
|
Fügt dem angegebenen Cachecluster-Konfigurationsspeicher einen Cachehost hinzu. |
|
|
Hebt die Konfiguration der Cacheverwaltung auf dem Cachehost auf. Dieser Befehl wird lokal auf dem Server ausgeführt. |
|
|
Entfernt eine vorhandene Clusterkonfiguration. |
|
|
Hebt die Konfiguration eines Cachehosts auf, der aktuell nicht Mitglied eines Cacheclusters ist. Dieser Befehl wird lokal auf dem Server ausgeführt. |
|
|
Legt einen benutzerdefinierten Speicherort für Protokolldateien fest, der für die Protokollierung von Konfigurationsbefehlen verwendet werden soll. Standardmäßig befinden sich die Protokolle im Ordner Temp. |
|
|
Speichert die Verbindungszeichenfolge persistent für die temporäre Verwendung. Die Verbindungszeichenfolge kann dann mit „Get-CacheConnectionString“ abgerufen werden. Beachten Sie, dass dieser Befehl die vom Cachecluster-Konfigurationsspeicher verwendete Verbindungszeichenfolge nicht ändert. Hinweis Dieser Befehl wird intern von Microsoft AppFabric 1.1 für Windows Server verwendet. Es sind keine Benutzerszenarien bekannt, die seine Verwendung erfordern. |
|
|
Überprüft die Verbindung mit einem Cachecluster-Konfigurationsspeicher. |
|
|
Entfernt einen Cachehosteintrag aus einem Cachecluster-Konfigurationsspeicher. Für die Aufhebung der Registrierung des aktuellen Hosts ist der HostName-Parameter nicht erforderlich. In diesem Fall sind die Parameter Provider und ConnectionString ebenfalls optional, unter der Annahme, dass der aktuelle Cachehost konfiguriert ist und der Befehl „Remove-CacheHost“ nicht für den Cachehost aufgerufen wurde. Warnung
|
Siehe auch
Konzepte
Verwenden von Windows PowerShell zum Verwalten von AppFabric 1.1-Cachefunktionen
Konfigurationseinstellungen
AppFabric-Cachekonfigurationsoptionen
Problembehandlung von AppFabric
AppFabric-Cachekonzepte (AppFabric 1.1-Cache)
Entwickeln eines Cacheclients
2012-04-05