Cacheverwaltung mit Windows PowerShell (Windows Server AppFabric-Cache)
Mit Windows PowerShell können Sie den Cachecluster, die Cachehosts und den Cache als solchen verwalten. Wenn Sie einen Computer verwenden, auf dem das Cacheverwaltungsfeature installiert ist, gibt es für die Nutzung von Windows PowerShell für die Verwaltung der Cachefeatures von AppFabric zwei Möglichkeiten. Wechseln Sie vom Menü Start aus zu Verwaltung, und wählen Sie dann Windows PowerShell-Module aus. Alternativ können Sie im Menü Start auf Alle Programme und dann auf Windows Server AppFabric klicken. Klicken Sie anschließend auf Windows PowerShell-Cacheverwaltung.
Hinweis
Unter den Betriebssystemen Windows Vista, Windows 7 und Windows Server 2008 müssen Sie Windows PowerShell mit Administratorrechten ausführen, damit einige Verwaltungsbefehle ordnungsgemäß funktionieren. Dazu müssen Sie mit der rechten Maustaste auf die Verknüpfung Windows PowerShell-Cacheverwaltung klicken und dann Als Administrator ausführen auswählen.
Es gibt zwei Hauptkategorien mit PowerShell-Befehlen für das AppFabric-Cachingfeature: Verwaltungsbefehle und Konfigurationsbefehle. Dieses Thema legt den Schwerpunkt auf die Verwaltungsbefehle. Weitere Informationen zu den Konfigurationsbefehlen finden Sie unter Cachekonfiguration mit Windows PowerShell (Windows Server AppFabric-Cache). In den Tabellen in diesem Thema werden die Verwaltungsbefehle in Kategorien unterteilt. Einige Befehle werden in mehr als einer Tabelle erörtert, wobei die unterschiedlichen Parameter aufgeführt werden, die zu jeweils einer der folgenden vier Befehlskategorien gehören:
Cacheclusterbefehle
Cachehostbefehle
Cachebefehle
Konsolenverwaltungsbefehle
Aufrufen der Hilfe in einer Windows Power-Sitzung
Die nachstehenden Informationen stellen eine Zusammenfassung der Verwaltungsbefehle für die Cachefeatures 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 Verwaltungsbefehle angezeigt:
get-command -module DistributedCacheAdministration
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 New-Cache
angezeigt:
get-help New-Cache -full
Wichtige Überlegungen
Bei Verwendung der in diesem Thema beschriebenen Windows PowerShell-Befehle sollten die folgenden Punkte unbedingt berücksichtigt werden:
Die Sicherheitsidentität der Person, die diese Windows PowerShell-Befehle verwendet, muss über Administratorrechte für alle Cacheserver im Cachecluster verfügen.
Bei den Parameterwerten für die Befehle wird die Groß-/Kleinschreibung berücksichtigt. Wenn Sie beispielsweise einen Cache mit Namen
NamedCache1
erstellen, funktioniert der BefehlGet-CacheConfig -CacheName namedcache1
nicht ordnungsgemäß. Die Groß-/Kleinschreibung muss wie inGet-CacheConfig -CacheName NamedCache1
gezeigt übereinstimmen.Wenn Sie mit den Befehlen
Export-CacheClusterConfig
undImport-CacheClusterConfig
Änderungen an der XML-basierten Clusterkonfiguration vornehmen, können Sie die Clusterkonfigurationseinstellungen (XML-Attribute) in der XML-Datei zwar ändern, das Hinzufügen oder Entfernen von benannten Caches und Cachehosts durch Einfügen oder Entfernen von XML-Elementen wird jedoch nicht unterstützt.Die Cacheclusterbefehle
Start-CacheCluster
,Stop-CacheCluster
undRestart-CacheCluster
implizieren die Koordination des Status des Windows-Cachehostdiensts auf allen Cacheservern im Cluster. Für diese Befehle wird ggf. mehr Zeit benötigt, wenn die Clusterverwaltungsrolle von führenden Hosts ausgeübt wird; es muss eine Mehrzahl von führenden Hosts ausgeführt werden, während der Rest der Cachehosts gestoppt und gestartet wird.Starten und Beenden Sie den Cachedienst immer mit den Cacheclusterbefehlen
Start-CacheCluster
,Stop-CacheCluster
undRestart-CacheCluster
. Das Starten und Beenden des Diensts aus dem Verwaltungstool Dienste kann zum Aufhängen des Systems führen. Ferner müssen diese Befehle mit Administratorberechtigungen in einer Windows PowerShell-Sitzung mit erhöhten Rechten ausgeführt werden.Die Cacheclusterbefehle
Stop-CacheCluster
oderRestart-CacheCluster
bewirken, dass alle Daten aus den Arbeitsspeichern aller Cachehosts im Cluster entfernt werden.Die Befehle
Set-CacheConfig
undImport-CacheClusterConfig
setzen voraus, dass Sie den Cachecluster mitRestart-CacheCluster
erneut starten, damit die Änderungen wirksam werden.Die Befehle
Remove-Cache
undNew-Cache
können zum Ändern der Konfiguration eines benannten Caches verwendet werden, ohne dass andere benannte Caches im Cluster hiervon betroffen sind.
Cacheclusterbefehle
Die folgende Tabelle enthält die Windows PowerShell-Befehle für die Cacheverwaltung, mit denen clusterbezogene Vorgänge ausgeführt werden können.
Befehl | Beschreibung |
---|---|
|
Legt den Kontext der Windows PowerShell-Sitzung auf den gewünschten Cachecluster fest. Wenn Sie eine Windows PowerShell-Sitzung starten, müssen Sie diesen Befehl zuerst ausführen. Auf einem Cachehost führen Sie den Befehl ohne Parameter aus, da die Parameter der Cachekonfiguration auf dem Computer entnommen werden. Wenn Sie den Befehl auf einem Computer ausführen, der nicht als Host konfiguriert ist, verwenden Sie die nachstehenden Parameter, um den gewünschten Cachecluster anzugeben. Im Folgenden finden Sie die Parameterbeschreibungen (Alias):
|
|
Startet alle Cachedienste im Cluster. Führende Hosts werden zuerst gestartet. Beachten Sie, dass Cachedienste nach einem Neustart nicht automatisch erneut gestartet werden, daher muss entweder |
|
Stoppt alle Cachedienste im Cluster. Für diesen Befehl werden Administratorrechte benötigt. |
|
Startet alle Cachedienste im Cluster in der richtigen Reihenfolge erneut. Für diesen Befehl werden Administratorrechte benötigt. |
|
Gibt statistische Daten zur Integrität des Cacheclusters zurück. |
|
Wurde entwickelt, um in Kombination mit Mit diesem Befehl werden die Clusterkonfigurationseinstellungen wie aktuell im Cluster vorhanden in die angegebene XML-basierte Konfigurationsdatei exportiert. Dieser Befehl kann ungeachtet des für die Clusterkonfigurationseinstellungen ausgewählten Speicherorts (SQL Server oder freigegebener Netzwerkordner) verwendet werden. Die Parameterbeschreibung (Alias):
Beispiel: |
|
Wurde entwickelt, um in Kombination mit Mit diesem Befehl werden die Clusterkonfigurationseinstellungen wie in der angegebenen XML-basierten Konfigurationsdatei festgelegt importiert. Dieser Befehl kann ungeachtet des für die Clusterkonfigurationseinstellungen ausgewählten Speicherorts (SQL Server oder freigegebener Netzwerkordner) verwendet werden. Sie müssen den Cluster mit Die Parameterbeschreibung (Alias):
Beispiel: |
|
Gewährt einem Windows-Konto Zugriff auf den Cachecluster. Standardmäßig können alle Administratorkonten auf den Cachehosts auf den Cachecluster zugreifen. Andere Konten müssen mit diesem Befehl ausdrücklich der Liste der zulässigen Clientkonten hinzugefügt werden. Die Parameterbeschreibung (Alias):
|
|
Widerruft das Zugriffsrecht eines Windows-Kontos auf den Cachecluster. Hiermit wird nicht verhindert, dass Administratoren von Cachehosts auf den Cachecluster zugreifen. Die Parameterbeschreibung (Alias):
|
|
Bei Verwendung ohne Parameter werden Informationen über alle Caches im gesamten Cachecluster aufgelistet. Hinweis Informationen zur Verwendung dieses Befehls mit dem Parameter |
Cachehostbefehle
Die folgende Tabelle enthält Windows PowerShell-Befehle, mit denen cachehostbezogene Vorgänge ausgeführt werden können.
Befehl | Beschreibung |
---|---|
|
Gibt Informationen über den angegebenen Cachehost zurück. Wenn keine Parameter übergeben werden, werden alle Cachedienste aufgeführt, die Mitglied des Cacheclusters sind. Im Folgenden finden Sie die Parameterbeschreibungen (Alias):
Beispiel: |
|
Gibt die Konfigurationsinformationen zum angegebenen Cachehost zurück. Im Folgenden finden Sie die Parameterbeschreibungen (Alias):
Beispiel: |
|
Aktualisiert die Cachehostkonfiguration auf die in den Befehlsparametern angegebenen Werte. Mit Ausnahme von Im Folgenden finden Sie die Parameterbeschreibungen (Alias):
Beispiel: |
|
Startet den angegebenen Cachedienst. Nach dem Neustart eines Cacheservers ist dieser Befehl erforderlich, damit der Cachedienst wieder Mitglied eines laufenden Cacheclusters wird. Beachten Sie, dass bei inaktivem Cachecluster stattdessen der Befehl Im Folgenden finden Sie die Parameterbeschreibungen (Alias):
Beispiel: |
|
Stoppt den angegebenen Cachedienst. Hinweis Der Im Folgenden finden Sie die Parameterbeschreibungen (Alias):
Beispiel: |
|
Zeigt statistische Daten wie die folgenden zum angegebenen Cachehost an: Gesamtgröße (in Byte) und die Anzahl von zwischengespeicherten Objekten, Bereichen, benannten Caches, Anforderungen und Cachefehlern. Hinweis Informationen zur Verwendung dieses Befehls mit dem Parameter Im Folgenden finden Sie die Parameterbeschreibungen (Alias):
Beispiel: |
|
Führt alle Caches und Bereiche an, die sich auf dem angegebenen Cachehost befinden. Im Folgenden finden Sie die Parameterbeschreibungen (Alias):
Beispiel: |
|
Gibt eine Liste aller Bereiche im Cachecluster zurück. Bereiche können nur vom Cacheclient erstellt oder entfernt werden. Der Cachecluster bestimmt jedoch den Cachehost, auf dem sich die Bereiche befinden sollen. Alle Parameter sind optional. Hinweis Informationen zur Verwendung dieses Befehls mit dem Parameter Im Folgenden finden Sie die Parameterbeschreibungen (Alias):
Beispiel: |
Cachebefehle
Die folgende Tabelle enthält Windows PowerShell-Befehle, mit denen cachebezogene Vorgänge ausgeführt werden können.
Befehl | Beschreibung |
---|---|
|
Erstellt einen neuen benannten Cache, wenn der Cluster ausgeführt wird. Alle Werte außer Hinweis Es besteht ein Grenzwert von 128 benannten Caches. Im Folgenden finden Sie die Parameterbeschreibungen (Alias):
Beispiel: |
|
Entfernt einen mit dem Parameter Die Parameterbeschreibung (Alias):
Beispiel: |
|
Gibt die Konfigurationsdetails für den mit dem Parameter Die Parameterbeschreibung (Alias):
Beispiel: |
|
Aktualisiert die Konfigurationseinstellungen des mit dem Parameter Wenn mit dem Parameter Weitere Informationen finden Sie unter Bearbeiten der Cachekonfigurationseinstellungen mit Windows PowerShell (Windows Server AppFabric-Cache). Im Folgenden finden Sie die Parameterbeschreibungen (Alias):
Beispiel: |
|
Gibt statistische Daten zu einem mit dem Parameter Hinweis Informationen zur Verwendung dieses Befehls mit den Parametern Die Parameterbeschreibung (Alias):
Beispiel: |
|
Gibt eine Liste aller Bereiche in dem mit dem Parameter Hinweis Informationen zur Verwendung dieses Befehls mit den Parametern Die Parameterbeschreibung (Alias):
Beispiel: |
Konsolenverwaltungsbefehle
Die folgende Tabelle enthält Befehle für Vorgänge zur Verwaltung des auf Windows PowerShell basierenden Cacheverwaltungstools.
Befehl | Beschreibung |
---|---|
|
Mit diesem Befehl wird die dateibasierte Protokollierung für die Sitzung mit dem auf Windows PowerShell basierenden Cacheverwaltungstool aktiviert. Die mit diesem Befehl gestartete Ereignisablaufverfolgung gilt nur für die Dauer der Windows PowerShell-Sitzung, von der aus sie aufgerufen wurde. Standardmäßig erfolgt die Protokollierung auf der Stufe Wenn bereits eine Datei mit dem gleichen Namen vorhanden ist, versucht Windows PowerShell, die Daten an die Protokolldatei anzufügen. Die Parameterbeschreibungen (Alias):
In diesem Beispiel wird die Datei
Mit diesem Befehl werden nur Ereignisse für die Windows PowerShell-Sitzung und nicht für den Cacheclient oder den Cachehost erfasst. |
|
Hiermit wird manuell die Garbage Collection auf dem Cachecluster aufgerufen, um nicht verwendeten Arbeitsspeicher freizugeben. Dieser Befehl steht nur unter besonderen Umständen zur Verfügung. Die Garbage Collection wird normalerweise von .NET Framework und den Arbeitsspeicherverwaltungsfeatures des AppFabric-Cacheclusters verwaltet. |
|
Stellt Hilfe zu allen unterstützten Befehlen bereit. Dieses Schlüsselwort kann auch mit dem Zeichen „*“ verwendet werden, um die Menge der angezeigten Hilfeinformationen zu filtern. Beispiel:
|
|
Beendet die Windows PowerShell-Sitzung. |
|
Löscht den Windows PowerShell-Bildschirm. |
Siehe auch
Konzepte
Cachekonfiguration mit Windows PowerShell (Windows Server AppFabric-Cache)
Konfigurationseinstellungen (Windows Server AppFabric-Cache)
Windows Server AppFabric-Cachekonfigurationsoptionen
Windows Server AppFabric-Cache – Problembehebung
Windows Server AppFabric-Cachekonzepte
Entwickeln eines Cacheclients (Windows Server AppFabric-Cache)
2011-12-05