Novo cache - cmdlet do PowerShell
Este cmdlet do PowerShell permite ao usuário criar um novo cache em um ou mais nós de servidor. Um novo cache pode ser criado por configurações especificadas pelo usuário em um arquivo de configuração colocado no caminho fornecido pelo usuário se o usuário não quiser usar as configurações padrão.
Você pode criar um cache com as seguintes topologias usando este cmdlet do PowerShell:
Local
Mirror
Replicated
Partitioned
PartitionReplica
(NCache Enterprise apenas)
Além disso, você também deve especificar o InMemoryStoreType
para essas topologias como parte deste cmdlet do PowerShell. Eles são os seguintes:
DistributedCache
DistributedCacheWithPersistence
(Apenas paraLocal
,PartitionReplica
ePartitioned
topologias)PubSubMessaging
DistributedLuceneWithPersistence
(Apenas paraLocal
,PartitionReplica
ePartitioned
topologias)
Note
É recomendável que você use a serialização JSON se estiver usando ASP.NET 5.0 e superior. Para mais detalhes clique SUA PARTICIPAÇÃO FAZ A DIFERENÇA. Também o DistributedCacheWithPersistence
e DistributedLuceneWithPersistence
os tipos de armazenamento na memória são compatíveis apenas com a serialização 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]
Note
Se você fornecer um caminho para o seu config.ncconf arquivo através do Path
parâmetro em seu comando, então InMemoryStoreType
parâmetro não pode ser usado. Se for usado, você receberá uma mensagem de erro.
Exemplos de novo cache - cmdlet do PowerShell
- Este comando cria um novo cache denominado demoCache no servidor 20.200.20.11 com tamanho de 1024 MB e usa topologia local, pois nenhuma topologia é especificada.
New-Cache -Name demoCache -Server 20.200.20.11 -Size 1024
- Este comando cria um novo cache denominado demoCache no servidor 20.200.20.11 com tamanho de 1024 MB, com a configuração que existe no caminho especificado.
New-Cache -Name demoCache -Server 20.200.20.11 –Path C:\config.xml
- Este comando cria um novo cache denominado demoCache no servidor 20.200.20.11, com tamanho 1024 MB e topologia definida como Replicada e ocupando a porta número 8701.
New-Cache -Name demoCache -Server 20.200.20.11 -Size 1024 –Topology Replicated –ClusterPort 8701
- Este comando cria um novo cache denominado demoCache no servidor 20.200.20.11 com tamanho de 1024 MB, topologia como Particionada, política de despejo definida como baseada em prioridade e prioridade definida como alta, bem como taxa de despejo definida como 10%. O intervalo de limpeza do cache será de 20 segundos.
New-Cache -Name demoCache -Server 20.200.20.11 -Size 1024 –Topology Partitioned –EvictionPolicy priority –DefaultPriority high –EvictionRatio 10 –CleanupInterval 20 -ClusterPort 8701
- Este comando cria um novo cache distribuído denominado demoCache nos servidores 20.200.20.11 e 20.200.20.12 com tamanho de 1024 MB, topologia replicada e ocupando a porta 8701 para casos simples.
New-Cache -Name demoCache -Server "20.200.20.11,20.200.20.12" -Size 1024 -Topology Replicated -ClusterPort 8701
- Este comando cria um novo Cache Distribuído denominado demoCache com tipo de armazenamento PubSubMessaging no servidor 20.200.20.11 tendo tamanho 1024 MB com topologia particionada e ocupando a porta 8701 para casos simples.
New-Cache -Name demoCache -Server "20.200.20.11" -Size 1024 -InMemoryStoreType PubSubMessaging -Topology Partitioned
- Este comando cria um novo Cache Lucene Distribuído denominado LuceneCache do tipo de armazenamento DistributedLuceneWithPersistence nos servidores 20.200.20.11 e 20.200.20.12 com tamanho de 1024 MB com replicação habilitada. O índice Lucene é criado em C:\LuceneIndexes\LuceneCache em todos os nós do servidor.
New-Cache -Name LuceneCache -Server "20.200.20.11,20.200.20.12" -Size 1024 -InMemoryStoreType DistributedLuceneWithPersistence -LuceneIndexPath "C:\LuceneIndexes" -Topology PartitionReplica
- Este comando cria um novo Cache Lucene Distribuído denominado LuceneCache do tipo de armazenamento DistributedLuceneWithPersistence nos servidores 20.200.20.11 e 20.200.20.12. Já que estamos usando
UseExistingIndex
sinalizador, os índices serão carregados do local padrão dos índices para o cache atual, que é C: \ ProgramData \ncache\lucene-index\LuceneCache, desde que tenhamos um mapa de módulo válido no local especificado em todos os nós do servidor. Mapa de módulo válido significa o mesmo nome de cache, a mesma topologia e os mesmos nós participantes do cache original, que foi usado para gerar esses índices.
New-Cache -Name LuceneCache -Server "20.200.20.11,20.200.20.12" -Size 1024 -InMemoryStoreType DistributedLuceneWithPersistence -UseExistingIndex -Topology PartitionReplica
- Este comando cria um novo cache distribuído com persistência denominado PersistenceCache do tipo de armazenamento DistributedCacheWithPersistence nos servidores 20.200.20.11 e 20.200.20.12 com tamanho 1024 MB com replicação habilitada. Um novo armazenamento de persistência chamado persistence_store é criado em \\Servidor de arquivos\lojas\store1 em todos os nós do servidor.
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
Propriedades
Note
Os parâmetros com asterisco (*) em seus nomes são os parâmetros obrigatórios e os demais são opcionais.
parâmetros | Tipos de dados | Descrição | Valor padrão |
---|---|---|---|
-Name* |
<String> |
Especifica o nome do novo cache que deve ser registrado. | - |
-Server |
<String> |
Especifica o NCache nomes/IPs de servidores onde o Cache deve ser configurado, separados por vírgulas, por exemplo, 20.200.20.11, 20.200.20.12. | Máquina local |
-CleanupInterval |
<Integer> |
Especifica o intervalo de tempo em segundos após o qual a limpeza do cache é chamada e todos os itens expirados são limpos do cache. | 15 segundos |
-ClusterPort |
<Integer> |
Especifica a porta do servidor, na qual o servidor atende. | - |
-DefaultPriority |
<String> |
Se a política de despejo escolhida pelo usuário for baseada em Prioridade; este parâmetro especifica a prioridade padrão. Os valores possíveis são |
Normal |
-EvictionPolicy |
<String> |
Especifica a política de despejo para itens de cache. Os itens armazenados em cache serão limpos do cache de acordo com a política especificada se o cache atingir seu limite. Os valores possíveis são NOTA: LRU e LFU estão disponíveis apenas na edição Enterprise. |
LRU |
-EvictionRatio |
<Decimal> |
Especifica a taxa de despejo (Porcentagem) para itens de cache. Os itens armazenados em cache serão limpos do cache de acordo com a proporção especificada se o cache atingir seu limite. | 5% |
-Inproc |
<SwitchParamter> |
Especifica o nível de isolamento para o cache local. | Falso |
-SerializationFormat |
<SwitchParamter> |
Especifica o formato de serialização dos objetos armazenados no cache. Os valores possíveis são |
Binário para DistributedCache e PubSubMessaging cache. JSON para DistributedCacheWithPersistence e DistributedLuceneWithPersistence esconderijo |
-NoLogo |
<SwitchParameter> |
Suprime a exibição do banner do logotipo. | Falso |
-Path |
<String> |
Especifica o caminho do arquivo de configuração se o usuário não quiser usar as configurações padrão. | - |
-Port |
<Integer> |
Especifica a porta do servidor onde NCache o servidor está escutando. | 8250 |
-ReplicationStrategy |
<String> |
Se a topologia escolhida pelo usuário for Réplica Particionada; este parâmetro especifica a estratégia de replicação. Os valores possíveis são |
Assíncrono |
-Size |
<Long> |
Especifica o tamanho do Cache que deve ser criado recentemente. | 1024 (Para Cache Local) |
-Topology |
<String> |
Para topologia diferente de local você tem que dar topologia e porta do cluster. Especifica a topologia no caso de cache em cluster. As topologias possíveis são Mirror Replicated Partitioned PartitionReplica NOTA: PartitionReplica está disponível apenas na edição Enterprise. |
Local |
Credentials |
<pscredential> |
Especifica as credenciais do usuário necessárias para autorizar o acesso à operação especificada. Essas credenciais devem pertencer a um usuário que possua permissões apropriadas no nó. | - |
-InMemoryStoreType |
<String> |
Especifica a finalidade para a qual esse cache será usado. Os valores possíveis são: DistributedCache DistributedCacheWithPersistence PubSubMessaging DistributedLuceneWithPersistence |
DistributedCache |
-UseExistingIndex |
<SwitchParameter> |
Especifica se o cache deve usar um índice existente ou criar um novo. | Falso |
-LuceneIndexPath |
<String> |
Especifica o caminho onde os índices lucene serão armazenados. Este parâmetro é necessário se o tipo de armazenamento deste cache for DistributedLuceneWithPersistence . |
- |
-PersistenceStoreName |
<String> |
Especifica o nome do armazenamento de persistência. Este parâmetro é obrigatório se o tipo de armazenamento para este cache for DistributedCacheWithPersistence . |
- |
-NewPersistenceStore |
<SwitchParameter> |
Especifica que um novo armazenamento seja criado para este cache. | Verdadeiro |
-PersistenceStoreConnectionString |
<String> |
Especifica uma cadeia de conexão válida para armazenamento de persistência. Este parâmetro é necessário se o tipo de armazenamento deste cache for Distributed Cache With Persistence . |
- |