Nouveau cache - Applet de commande PowerShell
Cette applet de commande PowerShell permet à l'utilisateur de créer un nouveau cache sur un ou plusieurs nœuds de serveur. Un nouveau cache peut être créé par les configurations spécifiées par l'utilisateur dans un fichier de configuration placé sur le chemin fourni par l'utilisateur si l'utilisateur ne souhaite pas utiliser les configurations par défaut.
Vous pouvez créer un cache avec les topologies suivantes à l'aide de cette applet de commande PowerShell :
Local
Mirror
Replicated
Partitioned
PartitionReplica
(NCache Enterprise seulement)
De plus, vous devez également spécifier le InMemoryStoreType
pour ces topologies dans le cadre de cette applet de commande PowerShell. Ils sont les suivants :
DistributedCache
DistributedCacheWithPersistence
(Seulement pourLocal
,PartitionReplica
etPartitioned
topologies)PubSubMessaging
DistributedLuceneWithPersistence
(Seulement pourLocal
,PartitionReplica
etPartitioned
topologies)
Notes
Il est recommandé d'utiliser la sérialisation JSON si vous utilisez ASP.NET 5.0 et versions ultérieures. Pour plus de détails cliquez ici. Également DistributedCacheWithPersistence
ainsi que DistributedLuceneWithPersistence
Les types de magasins en mémoire prennent uniquement en charge la sérialisation JSON.
New-Cache [-Name] [-Server] [-CleanupInterval] [-ClusterPort] [-DefaultPriority] [-EvictionPolicy] [-EvictionRatio] [-Inproc] [-SerializationFormat] [-NoLogo ] [-Path] [-Port] [-ReplicationStrategy] [-Size] -Topology [-Credentials] [-InMemoryStoreType] [-UseExistingIndex] [-LuceneIndexPath] [-PersistenceStoreName] [-NewPersistenceStore] [-PersistenceStoreConnectionString]
Notes
Si vous fournissez un chemin vers votre config.ncconf fichier via le Path
paramètre dans votre commande, puis InMemoryStoreType
paramètre ne peut pas être utilisé. S'il est utilisé, un message d'erreur s'affichera.
Exemples de nouveau cache - Applet de commande PowerShell
- Cette commande crée un nouveau cache nommé demoCache sur le serveur 20.200.20.11 d'une taille de 1024 XNUMX Mo et utilise la topologie locale puisqu'aucune topologie n'est spécifiée.
New-Cache -Name demoCache -Server 20.200.20.11 -Size 1024
- Cette commande crée un nouveau cache nommé demoCache sur le serveur 20.200.20.11 d'une taille de 1024 XNUMX Mo, avec la configuration qui existe sur le chemin spécifié.
New-Cache -Name demoCache -Server 20.200.20.11 –Path C:\config.xml
- Cette commande crée un nouveau cache nommé demoCache sur le serveur 20.200.20.11, d'une taille de 1024 8701 Mo et d'une topologie définie sur Répliqué et occupant le numéro de port XNUMX.
New-Cache -Name demoCache -Server 20.200.20.11 -Size 1024 –Topology Replicated –ClusterPort 8701
- Cette commande crée un nouveau cache nommé demoCache sur le serveur 20.200.20.11 ayant une taille de 1024 10 Mo, une topologie partitionnée, une politique d'expulsion définie sur une priorité et une priorité aussi élevée ainsi qu'un taux d'expulsion défini sur 20 %. L'intervalle de nettoyage du cache sera de XNUMX secondes.
New-Cache -Name demoCache -Server 20.200.20.11 -Size 1024 –Topology Partitioned –EvictionPolicy priority –DefaultPriority high –EvictionRatio 10 –CleanupInterval 20 -ClusterPort 8701
- Cette commande crée un nouveau cache distribué nommé demoCache sur les serveurs 20.200.20.11 et 20.200.20.12 d'une taille de 1024 Mo, topologie répliquée et occupant le port 8701 pour un cas simple.
New-Cache -Name demoCache -Server "20.200.20.11,20.200.20.12" -Size 1024 -Topology Replicated -ClusterPort 8701
- Cette commande crée un nouveau cache distribué nommé demoCache avec le type de magasin PubSubMessaging sur le serveur 20.200.20.11 d'une taille de 1024 8701 Mo avec une topologie partitionnée et occupant le port XNUMX pour un cas simple.
New-Cache -Name demoCache -Server "20.200.20.11" -Size 1024 -InMemoryStoreType PubSubMessaging -Topology Partitioned
- Cette commande crée un nouveau cache Lucene distribué nommé LuceneCache de type de magasin DistributedLuceneWithPersistence sur les serveurs 20.200.20.11 et 20.200.20.12 d'une taille de 1024 XNUMX Mo avec la réplication activée. L'index Lucene est créé à C:\LuceneIndexes\LuceneCache sur tous les nœuds du serveur.
New-Cache -Name LuceneCache -Server "20.200.20.11,20.200.20.12" -Size 1024 -InMemoryStoreType DistributedLuceneWithPersistence -LuceneIndexPath "C:\LuceneIndexes" -Topology PartitionReplica
- Cette commande crée un nouveau cache Lucene distribué nommé LuceneCache de type de magasin DistributedLuceneWithPersistence sur les serveurs 20.200.20.11 et 20.200.20.12. Puisque nous utilisons
UseExistingIndex
flag, les index seront chargés à partir de l'emplacement par défaut des index pour le cache actuel qui est C: \ ProgramData \ncache\lucene-index\LuceneCache, à condition que nous disposions d'une carte de module valide à l'emplacement spécifié sur tous les nœuds du serveur. Une carte de module valide signifie le même nom de cache, la même topologie et les mêmes nœuds participants que le cache d'origine, qui a été utilisé pour générer ces index.
New-Cache -Name LuceneCache -Server "20.200.20.11,20.200.20.12" -Size 1024 -InMemoryStoreType DistributedLuceneWithPersistence -UseExistingIndex -Topology PartitionReplica
- Cette commande crée un nouveau cache distribué avec persistance nommé PersistenceCache de type de magasin DistributedCacheWithPersistence sur les serveurs 20.200.20.11 et 20.200.20.12 d'une taille de 1024 XNUMX Mo avec la réplication activée. Un nouveau magasin de persistance nommé persistence_store est créé à \\Serveur de fichiers\magasins\magasin1 sur tous les nœuds du serveur.
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
biens
Notes
Les paramètres avec un astérisque (*) sur leurs noms sont les paramètres obligatoires et les autres sont facultatifs.
Paramètres | Types de données | Description | Valeur par défaut |
---|---|---|---|
-Name* |
<String> |
Spécifie le nom du nouveau cache à enregistrer. | - |
-Server |
<String> |
Spécifie le NCache noms/IP des serveurs sur lesquels le cache doit être configuré, séparés par des virgules, par exemple 20.200.20.11, 20.200.20.12. | Machine locale |
-CleanupInterval |
<Integer> |
Spécifie l'intervalle de temps en secondes après lequel le nettoyage du cache est appelé et tous les éléments expirés sont effacés du cache. | en 15 secondes |
-ClusterPort |
<Integer> |
Spécifie le port du serveur, sur lequel le serveur écoute. | - |
-DefaultPriority |
<String> |
Si la politique d'éviction choisie par l'utilisateur est basée sur la priorité ; ce paramètre spécifie la priorité par défaut. Les valeurs possibles sont |
Normal |
-EvictionPolicy |
<String> |
Spécifie la stratégie d'éviction pour les éléments du cache. Les éléments mis en cache seront effacés du cache conformément à la politique spécifiée si le cache atteint sa limite. Les valeurs possibles sont REMARQUE: LRU et LFU sont uniquement disponibles dans l'édition Enterprise. |
Lru |
-EvictionRatio |
<Decimal> |
Spécifie le taux d'éviction (pourcentage) pour les éléments du cache. Les éléments mis en cache seront effacés du cache selon le ratio spécifié si le cache atteint sa limite. | 5% |
-Inproc |
<SwitchParamter> |
Spécifie le niveau d'isolation pour le cache local. | Faux |
-SerializationFormat |
<SwitchParamter> |
Spécifie le format de sérialisation des objets stockés dans le cache. Les valeurs possibles sont |
Binaire pour DistributedCache ainsi que PubSubMessaging cache. JSON pour DistributedCacheWithPersistence ainsi que DistributedLuceneWithPersistence cachette |
-NoLogo |
<SwitchParameter> |
Supprime l'affichage de la bannière du logo. | Faux |
-Path |
<String> |
Spécifie le chemin du fichier de configuration si l'utilisateur ne souhaite pas utiliser les configurations par défaut. | - |
-Port |
<Integer> |
Spécifie le port du serveur où NCache le serveur est à l'écoute. | 8250 |
-ReplicationStrategy |
<String> |
Si la topologie choisie par l'utilisateur est Réplique partitionnée ; ce paramètre spécifie la stratégie de réplication. Les valeurs possibles sont |
Async |
-Size |
<Long> |
Spécifie la taille du cache qui doit être nouvellement créé. | 1024 (pour le cache local) |
-Topology |
<String> |
Pour une topologie autre que local vous devez donner la topologie et le port du cluster. Spécifie la topologie en cas de cache en cluster. Les topologies possibles sont Mirror Replicated Partitioned PartitionReplica REMARQUE: PartitionReplica n'est disponible que dans l'édition Enterprise. |
Local |
Credentials |
<pscredential> |
Spécifie les informations d'identification utilisateur requises pour autoriser l'accès à l'opération spécifiée. Ces informations d'identification doivent appartenir à un utilisateur disposant des autorisations appropriées sur le nœud. | - |
-InMemoryStoreType |
<String> |
Spécifie le but pour lequel ce cache sera utilisé. Les valeurs possibles sont : DistributedCache DistributedCacheWithPersistence PubSubMessaging DistributedLuceneWithPersistence |
DistributedCache |
-UseExistingIndex |
<SwitchParameter> |
Spécifie si le cache doit utiliser un index existant ou en créer un nouveau. | Faux |
-LuceneIndexPath |
<String> |
Spécifie le chemin où les index Lucene seront stockés. Ce paramètre est obligatoire si le type de magasin pour ce cache est DistributedLuceneWithPersistence . |
- |
-PersistenceStoreName |
<String> |
Spécifie le nom du magasin de persistance. Ce paramètre est requis si le type de magasin pour ce cache est DistributedCacheWithPersistence . |
- |
-NewPersistenceStore |
<SwitchParameter> |
Spécifie qu'un nouveau magasin doit être créé pour ce cache. | Vrai |
-PersistenceStoreConnectionString |
<String> |
Spécifie une chaîne de connexion valide pour le magasin de persistance. Ce paramètre est obligatoire si le type de magasin pour ce cache est Distributed Cache With Persistence . |
- |