Neuer Cache – PowerShell-Cmdlet
Mit diesem PowerShell-Cmdlet kann der Benutzer einen neuen Cache auf einem oder mehreren Serverknoten erstellen. Ein neuer Cache kann durch benutzerspezifische Konfigurationen in einer Konfigurationsdatei erstellt werden, die in dem vom Benutzer angegebenen Pfad abgelegt wird, wenn der Benutzer die Standardkonfigurationen nicht verwenden möchte.
Mit diesem PowerShell-Cmdlet können Sie einen Cache mit den folgenden Topologien erstellen:
Local
Mirror
Replicated
Partitioned
PartitionReplica
(NCache Enterprise nur)
Darüber hinaus müssen Sie auch angeben InMemoryStoreType
für diese Topologien als Teil dieses PowerShell-Cmdlets. Sie sind wie folgt:
DistributedCache
DistributedCacheWithPersistence
(Nur fürLocal
,PartitionReplica
undPartitioned
Topologien)PubSubMessaging
DistributedLuceneWithPersistence
(Nur fürLocal
,PartitionReplica
undPartitioned
Topologien)
Note
Es wird empfohlen, die JSON-Serialisierung zu verwenden, wenn Sie ASP.NET 5.0 und höher verwenden. Für mehr Details klicken hier. Auch der DistributedCacheWithPersistence
und DistributedLuceneWithPersistence
In-Memory-Speichertypen unterstützen nur die JSON-Serialisierung.
New-Cache [-Name] [-Server] [-CleanupInterval] [-ClusterPort] [-DefaultPriority] [-EvictionPolicy] [-EvictionRatio] [-Inproc] [-SerializationFormat] [-NoLogo ] [-Path] [-Port] [-ReplicationStrategy] [-Size] -Topology [-Credentials] [-InMemoryStoreType] [-UseExistingIndex] [-LuceneIndexPath] [-PersistenceStoreName] [-NewPersistenceStore] [-PersistenceStoreConnectionString]
Note
Wenn Sie einen Pfad zu Ihrem angeben config.ncconf Datei durch die Path
Parameter in Ihrem Befehl, dann InMemoryStoreType
Parameter kann nicht verwendet werden. Wenn es verwendet wird, erhalten Sie eine Fehlermeldung.
Beispiele für New-Cache – PowerShell-Cmdlet
- Dieser Befehl erstellt einen neuen Cache mit dem Namen demoCache auf Server 20.200.20.11 mit einer Größe von 1024 MB und verwendet die lokale Topologie, da keine Topologie angegeben ist.
New-Cache -Name demoCache -Server 20.200.20.11 -Size 1024
- Dieser Befehl erstellt einen neuen Cache mit dem Namen demoCache auf Server 20.200.20.11 mit einer Größe von 1024 MB und der Konfiguration, die im angegebenen Pfad vorhanden ist.
New-Cache -Name demoCache -Server 20.200.20.11 –Path C:\config.xml
- Dieser Befehl erstellt einen neuen Cache mit dem Namen demoCache auf Server 20.200.20.11, mit einer Größe von 1024 MB und einer Topologie, die auf „Repliziert“ eingestellt ist und die Portnummer 8701 belegt.
New-Cache -Name demoCache -Server 20.200.20.11 -Size 1024 –Topology Replicated –ClusterPort 8701
- Dieser Befehl erstellt einen neuen Cache mit dem Namen demoCache auf Server 20.200.20.11 mit einer Größe von 1024 MB, einer Topologie wie „Partitioniert“, einer Räumungsrichtlinie, die auf „Priorität basiert“ und einer hohen Priorität sowie einem Räumungsverhältnis von 10 % festgelegt ist. Das Reinigungsintervall des Caches beträgt 20 Sekunden.
New-Cache -Name demoCache -Server 20.200.20.11 -Size 1024 –Topology Partitioned –EvictionPolicy priority –DefaultPriority high –EvictionRatio 10 –CleanupInterval 20 -ClusterPort 8701
- Dieser Befehl erstellt einen neuen verteilten Cache mit dem Namen demoCache auf den Servern 20.200.20.11 und 20.200.20.12 mit einer Größe von 1024 MB, einer replizierten Topologie und der Belegung des Ports 8701 im einfachen Fall.
New-Cache -Name demoCache -Server "20.200.20.11,20.200.20.12" -Size 1024 -Topology Replicated -ClusterPort 8701
- Dieser Befehl erstellt einen neuen verteilten Cache mit dem Namen demoCache und dem Speichertyp PubSubMessaging auf Server 20.200.20.11 mit einer Größe von 1024 MB und einer partitionierten Topologie, der im einfachen Fall den Port 8701 belegt.
New-Cache -Name demoCache -Server "20.200.20.11" -Size 1024 -InMemoryStoreType PubSubMessaging -Topology Partitioned
- Dieser Befehl erstellt einen neuen Distributed Lucene Cache mit dem Namen LuceneCache vom Speichertyp DistributedLuceneWithPersistence auf den Servern 20.200.20.11 und 20.200.20.12 mit einer Größe von 1024 MB und aktivierter Replikation. Der Lucene-Index wird unter erstellt C:\LuceneIndexes\LuceneCache auf allen Serverknoten.
New-Cache -Name LuceneCache -Server "20.200.20.11,20.200.20.12" -Size 1024 -InMemoryStoreType DistributedLuceneWithPersistence -LuceneIndexPath "C:\LuceneIndexes" -Topology PartitionReplica
- Dieser Befehl erstellt einen neuen Distributed Lucene Cache mit dem Namen LuceneCache vom Speichertyp DistributedLuceneWithPersistence auf den Servern 20.200.20.11 und 20.200.20.12. Da wir verwenden
UseExistingIndex
Flag, Indizes werden vom Standardspeicherort der Indizes für den aktuellen Cache geladen, der ist C: \ ProgramData \ncache\lucene-index\LuceneCache, vorausgesetzt, wir haben eine gültige Modulzuordnung am angegebenen Standort auf allen Serverknoten. Eine gültige Modulzuordnung bedeutet denselben Cache-Namen, dieselbe Topologie und dieselben teilnehmenden Knoten wie der ursprüngliche Cache, der zum Generieren dieser Indizes verwendet wurde.
New-Cache -Name LuceneCache -Server "20.200.20.11,20.200.20.12" -Size 1024 -InMemoryStoreType DistributedLuceneWithPersistence -UseExistingIndex -Topology PartitionReplica
- Dieser Befehl erstellt einen neuen verteilten Cache mit Persistenz namens PersistenceCache vom Speichertyp DistributedCacheWithPersistence auf den Servern 20.200.20.11 und 20.200.20.12 mit einer Größe von 1024 MB und aktivierter Replikation. Neuer Persistenzspeicher mit dem Namen persistence_store wird unter erstellt \\Dateiserver\stores\store1 auf allen Serverknoten.
New-Cache -Name PersistenceCache -Server "20.200.20.11,20.200.20.12" -Size 1024 -InMemoryStoreType DistributedCacheWithPersistence -PersistenceStoreName "persistence_store" -NewPersistenceStore -PersistenceStoreConnectionString "\\Fileserver\stores\store1;domain_name\user_name;password" -Topology PartitionReplica
Ferienhäuser
Note
Die Parameter mit Sternchen (*) in ihrem Namen sind die erforderlichen Parameter und der Rest ist optional.
Parameter | Datentypen | Beschreibung | Standardwert |
---|---|---|---|
-Name* |
<String> |
Gibt den Namen des neuen Caches an, der registriert werden soll. | - |
-Server |
<String> |
Gibt die an NCache Servernamen/IPs, auf denen der Cache konfiguriert werden soll, durch Kommas getrennt, z. B. 20.200.20.11, 20.200.20.12. | Lokale Maschine |
-CleanupInterval |
<Integer> |
Gibt das Zeitintervall in Sekunden an, nach dem die Cache-Bereinigung aufgerufen und alle abgelaufenen Elemente aus dem Cache gelöscht werden. | 15 Sekunden |
-ClusterPort |
<Integer> |
Gibt den Port des Servers an, an dem der Server lauscht. | - |
-DefaultPriority |
<String> |
Wenn die vom Benutzer gewählte Räumungsrichtlinie prioritätsbasiert ist; Dieser Parameter gibt die Standardpriorität an. Mögliche Werte sind |
Normal |
-EvictionPolicy |
<String> |
Gibt die Räumungsrichtlinie für Cache-Elemente an. Zwischengespeicherte Elemente werden gemäß der angegebenen Richtlinie aus dem Cache gelöscht, wenn der Cache sein Limit erreicht. Mögliche Werte sind Anmerkungen: LRU und LFU sind nur in der Enterprise Edition verfügbar. |
LRU |
-EvictionRatio |
<Decimal> |
Gibt das Räumungsverhältnis (Prozentsatz) für Cache-Elemente an. Zwischengespeicherte Elemente werden entsprechend dem angegebenen Verhältnis aus dem Cache gelöscht, wenn der Cache sein Limit erreicht. | 5% |
-Inproc |
<SwitchParamter> |
Gibt die Isolationsstufe für den lokalen Cache an. | falsch |
-SerializationFormat |
<SwitchParamter> |
Gibt das Serialisierungsformat der im Cache gespeicherten Objekte an. Mögliche Werte sind |
Binär für DistributedCache und PubSubMessaging Zwischenspeicher. JSON für DistributedCacheWithPersistence und DistributedLuceneWithPersistence Cache-Speicher |
-NoLogo |
<SwitchParameter> |
Unterdrückt die Anzeige des Logo-Banners. | falsch |
-Path |
<String> |
Gibt den Pfad der Konfigurationsdatei an, wenn der Benutzer die Standardkonfigurationen nicht verwenden möchte. | - |
-Port |
<Integer> |
Gibt den Server-Port an, an dem NCache Server lauscht. | 8250 |
-ReplicationStrategy |
<String> |
Wenn die vom Benutzer ausgewählte Topologie „partitioniertes Replikat“ ist; Dieser Parameter gibt die Replikationsstrategie an. Die möglichen Werte sind |
Asynchron |
-Size |
<Long> |
Gibt die Größe des Caches an, der neu erstellt werden soll. | 1024 (Für lokalen Cache) |
-Topology |
<String> |
Für andere Topologien als local Sie müssen Topologie und Cluster-Port angeben. Gibt die Topologie im Fall von Cluster-Cache an. Mögliche Topologien sind Mirror Replicated Partitioned PartitionReplica HINWEIS: PartitionReplica ist nur in der Enterprise Edition verfügbar. |
Local |
Credentials |
<pscredential> |
Gibt die Benutzeranmeldeinformationen an, die zum Autorisieren des Zugriffs für den angegebenen Vorgang erforderlich sind. Diese Anmeldeinformationen sollten einem Benutzer gehören, der über die entsprechenden Berechtigungen am Knoten verfügt. | - |
-InMemoryStoreType |
<String> |
Gibt den Zweck an, für den dieser Cache verwendet wird. Die möglichen Werte sind: DistributedCache DistributedCacheWithPersistence PubSubMessaging DistributedLuceneWithPersistence |
DistributedCache |
-UseExistingIndex |
<SwitchParameter> |
Gibt an, ob der Cache einen vorhandenen Index verwenden oder einen neuen erstellen soll. | falsch |
-LuceneIndexPath |
<String> |
Gibt den Pfad an, in dem Lucene-Indizes gespeichert werden. Dieser Parameter ist erforderlich, wenn der Speichertyp für diesen Cache lautet DistributedLuceneWithPersistence . |
- |
-PersistenceStoreName |
<String> |
Gibt den Namen des Persistenzspeichers an. Dieser Parameter ist erforderlich, wenn der Speichertyp für diesen Cache ist DistributedCacheWithPersistence . |
- |
-NewPersistenceStore |
<SwitchParameter> |
Gibt an, dass ein neuer Speicher für diesen Cache erstellt wird. | Wahre |
-PersistenceStoreConnectionString |
<String> |
Gibt eine gültige Verbindungszeichenfolge für den Persistenzspeicher an. Dieser Parameter ist erforderlich, wenn der Speichertyp für diesen Cache lautet Distributed Cache With Persistence . |
- |