Administração de cache com o Windows PowerShell (AppFabric 1.1)

Use-CacheCluster

Connect-AFCacheClusterConfiguration

Define o contexto de sua sessão do Windows PowerShell para o cluster de cache desejado.

Quando você iniciar uma sessão do Windows PowerShell, primeiro execute esse comando. Se ele estiver em um host de cache, você deverá executar o comando sem parâmetros, uma vez que eles serão obtidos da configuração de cache do computador. Se você estiver executando o comando de um computador não host, poderá usar os parâmetros a seguir para especificar o cluster de cache desejado.

As descrições de parâmetro são:

• Provider: o provedor usado para armazenar as definições de configuração do cluster. Ela pode ser System.Data.SqlClient ou XML, dependendo de como as informações de configuração estão armazenadas.
  
  
• ConnectionString: a cadeia de conexão para o banco de dados ou local do arquivo de configuração XML.
  
  

Stop-CacheCluster

Stop-AFCacheCluster

Interrompe todos os serviços de cache no cluster. Esse comando exige privilégios de administrador.

Get-CacheClusterHealth

Get-AFCacheClusterHealth

Retorna estatísticas sobre a integridade do cluster de cache.

Import-CacheClusterConfig

Import-AFCacheClusterConfiguration

Projetado para ser usado junto com Export-CacheClusterConfig, esse comando permite editar as definições de configuração de cluster com XML. Para obter mais informações, consulte Editar definições de configuração de cluster.

Esse comando importa as definições de configuração de cluster conforme descrito no arquivo de configuração baseado em XML especificado. Esse comando pode ser usado independentemente de onde você optou por armazenar suas definições de configuração de cluster (SQL Server ou pasta de rede compartilhada).

Reinicie o cluster com o Restart-CacheCluster para que as alterações sejam efetivadas.

A descrição do parâmetro é:

• File: o caminho e o nome totalmente qualificado do arquivo de configuração baseado em XML que descreve as definições de configuração do cluster de cache a serem aplicadas ao cluster.
  
  
• Force: importa o arquivo de configuração sem solicitar confirmação.
  
  
• RefreshNow: altera as definições de configuração de cluster de cache do cluster em execução. Atualmente, esse recurso funciona somente com definições relacionadas ao gerenciamento de memória. Entretanto, ainda assim os hosts de cache individuais devem ser reiniciados ou adicionados ao cluster para que as definições de gerenciamento de memória tenham efeito.
  
  

Exemplo: Import-CacheClusterConfig -File c:\CurrentClusterConfig.xml

Revoke-CacheAllowedClientAccount

Revoke-AFCacheAllowedClientAccount

Revoga um acesso de conta do Windows ao cluster de cache. Isso não impedirá os administradores nos hosts de cache de acessar o cluster de cache.

A descrição do parâmetro é:

• Account: a conta do Windows para conceder acesso ao cluster de cache.
  
  

Update-CacheHostAllowedVersions

Update-AFCacheHostAllowedVersions

Atualiza as variações de versão de hosts de cache e de clientes de cache que têm permissão para acessar o cluster de cache. Atualmente, os números de versão estão relacionados às seguintes versões:

• 1 = Windows Server AppFabric v1.0
  
  
• 3 = Microsoft AppFabric 1.1 para Windows Server
  
  

As descrições de parâmetro são:

1. BeginClientVersion: o valor inicial da variação de versão de clientes de cache.
   
   
2. EndClientVersion: o valor final da variação de versão de clientes de cache.
   
   
3. BeginServerVersion: o valor inicial da variação de versão de host de cache.
   
   
4. EndServerVersion: o valor final da variação de versão de host de cache.
   
   

Para obter mais informações, consulte Procedimento de Atualização para um Cluster de Cache do AppFabric (AppFabric 1.1).

Update-CacheConfigurationStore

Update-AFCacheConfigurationStore

Atualiza o armazenamento de configuração do cache após uma atualização do AppFabric. Ao atualizar para o Microsoft AppFabric 1.1 para Windows Server, causa-se o efeito visível da conversão dos nomes de host do cache para os seus nomes de domínio totalmente qualificados (FQDN) equivalentes.

Get-CacheHost

Get-AFCacheHost

Lista informações sobre o host de cache especificado. Se nenhum parâmetro for aprovado, todos os serviços de cache que são membros do cluster de cache serão listados. Observe que o status Shutting Down indica que há um encerramento normal em andamento.

As descrições de parâmetro são:

• HostName: o nome do host de cache.
  
  
• CachePort: o número da porta de cache do host de cache.
  
  

Exemplo: Get-CacheHost

Set-CacheHostConfig

Set-AFCacheHostConfiguration

Atualiza a configuração do host de cache para os valores especificados nos parâmetros de comando. Exceto para HostName e CachePort, todos os parâmetros são opcionais. Para obter mais informações, consulte Editar definições de configuração de cluster.

As descrições de parâmetro são:

• HostName: o nome do host de cache.
  
  
• CachePort: o número atual da porta de cache do host de cache.
  
  
• ClusterPortNumber: o número da porta de cluster usado pelo host de cache.
  
  
• ArbitratorPortNumber: o novo número da porta de arbitragem.
  
  
• ReplicationPortNumber: o novo número da porta de replicação.
  
  
• CacheSize: a quantidade total de memória alocada para armazenar dados no host de cache, em unidades de megabytes (MB).
  
  
• IsLeadHost: o status do host principal para o host de cache ("true" ou "false").
  
  
• HWM: a porcentagem de marca d' água alta de memória, quando a remoção deve começar a eliminar objetos que ainda não expiraram.
  
  
• LWM: a porcentagem de marca d' água baixa de memória, quando a remoção deve começar a eliminar objetos expirados. Depois de atingir HWM, quando a remoção deve parar de eliminar objetos que ainda não expiraram.
  
  

Exemplo: Set-CacheConfig -HostName CacheServer1 -CachePort 22233 -LowWM 80

Stop-CacheHost

Stop-AFCacheHost

Interrompe o serviço de cache especificado.

As descrições de parâmetro são:

• HostName: o nome do host de cache.
  
  
• CachePort: o número da porta de cache do host de cache.
  
  
• HostTimeout: o valor de tempo limite em segundos para o host de cache especificado ser iniciado.
  
  

• Graceful: especifica que um encerramento normal deve ser iniciado. Um encerramento normal move os itens de cache para outros hosts de cache antes de interromper o Serviço de Cache. Isso evita a perda de dados e que o requisito de clientes de cache repopule esses itens. Observe que o cluster de cache pode ser criado usando o comando New-CacheCluster com a opção GracefulShutdownEnabled para tornar os desligamentos normais o comportamento padrão do comando Stop-CacheHost. Isto também exige que o cluster de cache especifique o GracefulShutdownTimeout.
  
  

  Aviso

  Apenas inicie um encerramento normal quando tiver certeza de que há servidores e memória restante suficientes para lidar com os itens de cache que são movidos para os servidores em execução. Caso contrário, o encerramento normal poderá travar e deverá ser cancelado.

Exemplo: Stop-CacheHost -HostName CacheServer1 -CachePort 22233

Restart-CacheHost

Restart-AFCacheHost

Reinicia o serviço de cache especificado. As configurações são iguais às de Stop-CacheHost.

Get-Cache

Get-AFCache

Lista todos os caches e regiões que residem no host de cache especificado.

As descrições de parâmetro são:

• HostName: o nome do host de cache.
  
  
• CachePort: o número da porta de cache do host de cache.
  
  

Exemplo: Get-Cache -HostName CacheServer1 -CachePort 22233

New-Cache

New-AFCache

Cria um novo cache nomeado quando o cluster está em execução. Todos os valores, exceto para CacheName, são opcionais.

As descrições de parâmetro são:

• CacheName: o nome do cache.
  
  
• Secondaries: o valor 1 habilita o recurso de alta disponibilidade. O valor 0 desabilita o recurso de alta disponibilidade. O valor padrão é 0.
  
  
• NotificationsEnabled: um valor igual a True habilita o recurso de notificações de cache, enquanto um valor igual a False desabilita-o.
  
  

• Eviction: um valor igual a LRU habilita a remoção Menos Utilizado Recentemente. Um valor igual a None desabilita a remoção. O valor padrão é LRU.
  
  

  Aviso

  Um valor igual a None pode fazer com que um host de cache fique sem memória.

• TimeToLive: o tempo limite padrão dos objetos armazenados em cache antes da expiração, em minutos. O valor padrão é 10.
  
  
• Expirable: um valor igual a True habilita a expiração, enquanto False a desabilita. O padrão é Verdadeiro.
  
  
• MinSecondaries: número mínimo de cópias secundárias de um item necessárias para que gravações em tal item sejam bem-sucedidas. O padrão é 0.
  
  
• WriteBehindEnabled: habilita o recurso de escrita atrasada. O padrão é false.
  
  
• WriteBehindInterval: o número de segundos pelo qual um item de cache deve ser gravado no provedor após ser gravado no cache. O mínimo é 60 e o padrão é 300.
  
  
• WriteBehindRetryInterval: o intervalo de tentativas, em segundos, de espera entre tentativas de repetição no caso de uma falha de conexão com o provedor de escrita atrasada. O valor padrão é 60, que também é o valor mínimo.
  
  
• WriteBehindRetryCount: o número máximo de tentativas de conexão com o provedor de escrita atrasada. O padrão é -1, o que significa tentativas infinitas.
  
  
• ReadThroughEnabled: habilita o recurso de read-through. O padrão é false.
  
  
• Provider Type: o nome plenamente qualificado do tipo de montagem do provedor. Esse provedor implanta os recursos escrita atrasada e read-through. O nome diferencia maiúsculas e minúsculas. Por exemplo: RTProvider.Provider, RTProvider, Version=1.0.0.0, Culture=neutral, PublicKeyToken=80e2cb5f6ba933f0.
  
  
• ProviderSettings: um ou mais pares chave/valor que especificam as informações de conexão para o provedor. Por exemplo: @{"setting1"="value1";"setting2"="value2"}.
  
  

Exemplo: New-Cache -CacheName NamedCache1 -Secondaries 1 -TimeToLive 15

Get-CacheConfig

Get-AFCacheConfiguration

Retorna os detalhes da configuração do cache nomeado especificado pelo parâmetro CacheName.

A descrição do parâmetro é:

• CacheName: o nome do cache.
  
  

Exemplo: Get-CacheConfig -CacheName NamedCache1

Get-CacheStatistics

Get-AFCacheStatistics

Retorna estatísticas de um cache nomeado, como especificado pelo parâmetro CacheName.

A descrição do parâmetro é:

• CacheName: o nome do cache.
  
  

Exemplo: Get-CacheStatistics -CacheName NamedCache1

Set-CacheLogging

Set-AFCacheLogging

Esse comando habilita o log baseado em arquivo para a sessão de ferramenta de administração de cache baseada no Windows PowerShell. O rastreamento de eventos iniciado por esse comando tem duração apenas nas sessões do Windows PowerShell a partir das quais ele foi chamado.

Por padrão, o log é habilitado no nível VERBOSE. O arquivo de log padrão está no diretório %temp% dos usuários com um nome formado pelo prefixo DCacheAdministration seguido pelo identificador do processo e o carimbo de data/hora de criação.

Se já existir um arquivo com o mesmo nome, o Windows PowerShell tentará anexar ao arquivo de log.

As descrições do parâmetro são:

• LogLevel: o nível de evento que especifica os tipos de eventos capturados pelo rastreamento. Os valores válidos são NONE, ERROR, WARNING, INFO e VERBOSE.
  
  
• File: um caminho absoluto de pasta ou arquivo em que os logs devem ser gravados. Se o nome do arquivo não for especificado, DCacheAdminTrace[<ProcessId>].log será assumido como padrão, em que <ProcessId> é o número da ID do processo do Windows da sessão do Windows PowerShell. ".log" é acrescentado em todos os nomes de arquivo especificados.
  
  

Este exemplo cria o arquivo c:\WarningLog.log que captura mensagens de aviso e de erro:

Set-CacheLogging -LogLevel WARNING -File c:\WarningLog

Este comando rastreia eventos apenas para a sessão do Windows PowerShell, não para o cliente de cache ou o host de cache.

Invoke-CacheGC

Invoke-AFCacheGarbageCollector

Chama manualmente a coleta de lixo no cluster de cache para liberar a memória não usada. Esse comando está disponível apenas para circunstâncias especiais. Geralmente, a coleta de lixo é gerenciada pelo .NET Framework e pelos recursos de gerenciamento de memória do cluster de cache do AppFabric.

cls

cls

Limpa a tela do Windows PowerShell.